Dịch vụ Kiểm soát Phiên bản Cục bộ
Việc cài đặt Enterprise Server cung cấp khả năng kiểm soát phiên bản được địa phương hóa (và tập trung), nhờ vào dịch vụ Kiểm soát Phiên bản (Version Control) của nó. Dịch vụ này mang đến khả năng kiểm soát phiên bản ngay tại nơi bạn cần, trên môi trường cục bộ, mà không cần phải tìm kiếm hay chi trả cho phần mềm quản lý hệ thống kiểm soát phiên bản (VCS) bên ngoài.
Bằng cách định nghĩa các kho lưu trữ thiết kế theo cách tập trung này, tổ chức có thể kiểm soát hoàn toàn các kho lưu trữ mà các nhà thiết kế có thể truy cập và sử dụng.
Những ưu điểm chính
Có hai ưu điểm chính khi sử dụng dịch vụ Kiểm soát Phiên bản tập trung này:
- Bạn có quản lý người dùng và quyền chung cho cả Altium Designer và SVN. Khi bạn đăng nhập vào Enterprise Server, dịch vụ Kiểm soát Phiên bản sẽ hoạt động với phiên làm việc/thông tin đăng nhập của bạn.
- Các kho lưu trữ được định nghĩa thông qua Enterprise Server (qua trang VCS trang (Admin – VCS) của giao diện dựa trên trình duyệt trong Enterprise Server Workspace) sẽ được tự động đồng bộ hóa với Altium Designer khi đăng nhập, do đó người dùng không cần lo lắng về URL, giao thức, mật khẩu, v.v. Việc cấu hình chỉ cần thực hiện một lần trên Enterprise Server và được chia sẻ với các người dùng mục tiêu theo yêu cầu.
Tạo kho lưu trữ
Các kho lưu trữ có thể được tạo thông qua dịch vụ Kiểm soát Phiên bản cục bộ (chỉ SVN), hoặc có thể kết nối với các kho lưu trữ bên ngoài (SVN hoặc Git). Tất cả các kho lưu trữ này đều được quản lý tập trung thông qua trang VCS trang (Admin – VCS) của giao diện dựa trên trình duyệt trong Workspace, bao gồm:
- Tên hiển thị, mô tả và đường dẫn kho lưu trữ.
- Quyền truy cập đã được cấu hình – những người dùng cụ thể nào có thể truy cập chúng (hoặc các nhóm trong trường hợp các kho lưu trữ được định nghĩa thông qua dịch vụ Kiểm soát Phiên bản cục bộ).
- Tính khả dụng của chúng – thêm hoặc xóa chúng tập trung, thay vì các nhà thiết kế phải tự tạo và kết nối với các kho lưu trữ một cách độc lập.
Khi người dùng Altium Designer đăng nhập vào Workspace, các kho lưu trữ thiết kế có sẵn cho họ sẽ tự động được thêm vào trang Quản lý dữ liệu – Kho lưu trữ thiết kế trong Preferences hộp thoại. Lưu ý rằng danh sách này cũng sẽ bao gồm bất kỳ kho lưu trữ 'không được quản lý' nào đã được thêm thủ công từ trang này Preferences trang này.
Xác định tập trung quyền truy cập vào các Kho lưu trữ Thiết kế của tổ chức bạn. Các kho lưu trữ có thể nằm trong hệ thống Enterprise Server, được định nghĩa bằng dịch vụ Kiểm soát Phiên bản cục bộ, hoặc bên ngoài thông qua việc sử dụng SVN tích hợp sẵn trong Altium Designer, hoặc dịch vụ SVN hoặc Git của bên thứ ba. Việc kiểm soát truy cập được thực hiện thông qua VCS trang của giao diện dựa trên trình duyệt trong Workspace. Khi người dùng đăng nhập vào Workspace, các Kho lưu trữ thiết kế mà họ có quyền truy cập sẽ tự động được thêm vào Data Management – Design Repositories trang của Preferences hộp thoại.
Thêm kho lưu trữ
Để thêm Kho lưu trữ thiết kế, hãy nhấp vào nút “
” (Thêm kho lưu trữ thiết kế), nằm ở góc trên bên phải của trang. Cửa sổ Add Repository Cửa sổ sẽ xuất hiện, hãy sử dụng cửa sổ này để định nghĩa kho lưu trữ.
Các thuộc tính cần thiết phụ thuộc vào việc bạn đang tạo một kho lưu trữ mới bằng dịch vụ Kiểm soát phiên bản cục bộ hay liên kết với một kho lưu trữ bên ngoài hiện có:
- New – Đặt tên và mô tả cho kho lưu trữ.
- Existing – Ngoài tên và mô tả, bạn cần cung cấp URL cho kho lưu trữ, cùng với thông tin đăng nhập hợp lệ (User Name, Password) để truy cập kho lưu trữ đó (nếu cần).
Tạo một kho lưu trữ thiết kế mới dựa trên SVN thông qua dịch vụ Kiểm soát Phiên bản cục bộ của Enterprise Server, hoặc liên kết với một kho lưu trữ hiện có (SVN hoặc Git) đã được tạo bên ngoài Enterprise Server.
Một kho lưu trữ thiết kế bên ngoài được liên kết sẽ được phân biệt trong danh sách các kho lưu trữ bằng External được đánh dấu
Để chỉnh sửa các thuộc tính của kho lưu trữ thiết kế ở giai đoạn sau, hãy nhấp vào Edit Để xóa kho lưu trữ thiết kế, hãy nhấp vào Remove
Chia sẻ kho lưu trữ
Sau khi đã tập trung các kho lưu trữ thiết kế, bạn cần đảm bảo rằng những người cần truy cập vào một kho lưu trữ cụ thể – bao gồm các nhà thiết kế sẽ làm việc trên các bản thiết kế mạch – có quyền truy cập đó. Điều này được thực hiện bằng cách chia sẻ kho lưu trữ đó, hay nói cách khác là quản lý quyền truy cập của nó. Để thực hiện việc này, hãy nhấp vào biểu tượng Share
Cửa Manage Permissions sẽ xuất hiện, kèm theo tất cả các tùy chọn cần thiết để chia sẻ kho lưu trữ với người dùng khác.
Với các kho lưu trữ thiết kế được tổ chức tập trung, việc chia sẻ với người khác chỉ đơn giản là quản lý quyền truy cập của từng kho lưu trữ.
Những điều cần lưu ý:
- Đối với kho lưu trữ cục bộ được tạo thông qua dịch vụ Kiểm soát Phiên bản của Enterprise Server (tức là không phải từ bên ngoài), quyền truy cập mặc định sẽ chia sẻ kho lưu trữ đó với người dùng đã tạo kho lưu trữ và Administrators nhóm. Cả hai đối tượng này đều có quyền truy cập Đọc/Ghi đầy đủ.
- Đối với kho lưu trữ bên ngoài, theo mặc định, kho lưu trữ này không được chia sẻ với ai cả – ngay cả người dùng đã thêm kết nối với kho lưu trữ đó thông qua giao diện cũng không được chia sẻ.
- Chỉ các kho lưu trữ cục bộ (không phải bên ngoài) mới có thể được chia sẻ với các nhóm đã định nghĩa trên Enterprise Server hoặc công khai. Các nhóm được liệt kê sau các người dùng cá nhân.
- Về quyền truy cập, một người dùng/nhóm có quyền Đọc/Ghi khi Can Write tùy chọn này được bật Nếu tùy chọn này bị tắt, họ chỉ có quyền truy cập Đọc.
- Để loại bỏ quyền truy cập chia sẻ của một người dùng/nhóm hiện có đối với kho lưu trữ, hãy nhấp vào Remove
Sharing a Local Repository with a Workspace User
Để chia sẻ một kho lưu trữ cục bộ (không phải bên ngoài) với một người dùng Workspace khác:
- Nhấp vào Add User trong Manage Permissions cửa sổ.
- Trong Add Users cửa sổ xuất hiện, bắt đầu nhập tên đầy đủ, tên người dùng hoặc địa chỉ email của một người dùng Workspace vào Select Users to be added trường này để hiển thị danh sách các người dùng phù hợp. Chọn người dùng cần thiết từ danh sách này. Có thể chọn nhiều người dùng. Để xóa một người dùng, hãy nhấp vào dấu X bên phải tên của họ.
- Đặt quyền cho (các) người dùng bằng cách sử dụng Permission trường này. Sử dụng menu thả xuống để chọn giữa Read quyền truy cập hoặc Read/Write quyền truy cập.
-
Nhấp vào nút “
” để xác nhận việc thêm người dùng và quay lại Manage Permissions cửa sổ.
-
Nhấp vào nút “
” trong Manage Permissions cửa sổ.
Sharing a Local Repository with a defined Group
Nếu kho lưu trữ được tạo thông qua dịch vụ Kiểm soát Phiên bản cục bộ, thay vì một kho lưu trữ bên ngoài, thì bạn cũng có thể chia sẻ với các nhóm được định nghĩa cho Không gian làm việc của mình. Để chia sẻ một kho lưu trữ cục bộ (không phải bên ngoài) với một nhóm khác:
- Nhấp vào Add Group trong Manage Permissions cửa sổ.
- Trong Add Groups cửa sổ xuất hiện, bắt đầu nhập tên của một nhóm vào Select Groups to be added trường, để hiển thị danh sách các nhóm phù hợp. Chọn nhóm cần thiết từ danh sách này. Có thể chọn nhiều nhóm. Để xóa một nhóm, hãy nhấp vào dấu X xóa, ở bên phải tên của nhóm đó.
- Đặt quyền truy cập cho (các) nhóm bằng cách sử dụng Permission trường này. Sử dụng menu thả xuống để chọn giữa Read quyền truy cập hoặc Read/Write quyền truy cập.
-
Nhấp vào nút “
” để xác nhận việc thêm nhóm và quay lại Manage Permissions cửa sổ.
-
Nhấp vào nút “
” trong Manage Permissions cửa sổ.
Sharing a Local Repository with All Users
Nếu kho lưu trữ đã được tạo thông qua dịch vụ Kiểm soát phiên bản cục bộ, thay vì một kho lưu trữ bên ngoài, thì bạn cũng có thể chia sẻ kho lưu trữ đó với tất cả người dùng Workspace. Để chia sẻ một kho lưu trữ cục bộ (không phải bên ngoài) với bất kỳ ai có thể đăng nhập vào Workspace:
- Nhấp vào Add Anyone trong Manage Permissions cửa sổ.
- Mục Anyone mục này sẽ được thêm trực tiếp vào danh sách các thực thể được chia sẻ và tự động được chia sẻ với quyền truy cập Đọc/Ghi.
-
Nhấp vào nút “
” trong Manage Permissions cửa sổ.
Sharing an External Repository with a Workspace User
Để chia sẻ kho lưu trữ bên ngoài với người dùng Workspace:
- Nhấp vào Add User nút điều khiển trong Manage Permissions cửa sổ.
-
Trong Add Users cửa sổ xuất hiện, bắt đầu nhập tên đầy đủ, tên người dùng hoặc địa chỉ email của một người dùng Workspace vào Select Users to be added trường này để hiển thị danh sách các người dùng phù hợp. Chọn người dùng cần thiết từ danh sách này. Để xóa người dùng, hãy nhấp vào dấu X xóa ở bên phải tên của họ.
Trong SVN User trường này, hãy nhập tên đã được đăng ký với kho lưu trữ bên ngoài (SVN hoặc Git) và do đó có quyền truy cập. Thông thường, đây sẽ là tên trùng khớp của người dùng đã được đăng ký với kho lưu trữ
-
Nhấp vào nút “
” để xác nhận việc thêm người dùng và quay lại Manage Permissions cửa sổ. Nhấp Add User để thêm người dùng khác như đã nêu ở bước 2 ở trên. Lưu ý rằng trong hình minh họa thứ hai bên dưới, người dùng Barryđã được thiết lập để sử dụng tên kho lưu trữ trùng khớp của mìnhBarrySmith, thay vìServerAdmin.
-
Nhấp vào nút “
” trong Manage Permissions cửa sổ.
Truy cập bên ngoài vào kho lưu trữ thiết kế SVN cục bộ
Có thể truy cập Kho lưu trữ thiết kế được tạo thông qua Dịch vụ kiểm soát phiên bản cục bộ của Enterprise Server bằng cách sử dụng máy khách SVN như TortoiseSVN. Việc truy cập được thực hiện bằng giao thức mạng thông thường ( svn:// hiện đang được hỗ trợ). Địa chỉ kho lưu trữ chính xác có thể được truy cập/sao chép từ hai vị trí:
- Trang VCS trang của giao diện trình duyệt Workspace – trong Repository Path trường dành cho kho lưu trữ đích.
Một kho lưu trữ 'nội bộ' được tạo từ Enterprise Server sẽ hiển thị đường dẫn địa chỉ tương đối so với Enterprise Server, tức là localhost địa chỉ của máy chủ.
- Từ bên trong Altium Designer, từ trang Quản lý Dữ liệu – Kho lưu trữ Thiết kế của Preferences – trong Repository trường dành cho kho lưu trữ đích.
Từ góc độ của Altium Designer – hoặc bất kỳ ứng dụng nào không nằm trên máy chủ Enterprise Server – các đường dẫn địa chỉ kho lưu trữ dựa trên tên của máy chủ tương ứng.
Sử dụng địa chỉ đã lấy được trong tính năng duyệt kho lưu trữ của trình khách Subversion. Lần truy cập đầu tiên, một Authentication sẽ mở ra yêu cầu thông tin đăng nhập hợp lệ. Nhập tên và mật khẩu của tài khoản người dùng Workspace để tiếp tục. Thông tin đăng nhập này chỉ hợp lệ nếu:
-
Tài khoản người dùng đã được thêm vào after kho lưu trữ được tạo trên Enterprise Server. Danh sách người dùng áp dụng cho các kho lưu trữ đã tạo có thể được xem trong
passwdtệp nằm trong thư mục\ProgramData\Altium\Altium365Data\Repository– xem bên dưới. -
Kho lưu trữ đã được chia sẻ với tài khoản người dùng đó bằng cách thêm tên người dùng đó thông qua Add User lệnh trong Manage Permissions for
. Điều này được thể hiện rõ trong tệp authz, nằm trong thư mục của máy tính Enterprise Server\ProgramData\Altium\Altium365Data\Repository.
Duyệt nội dung của Kho lưu trữ Thiết kế được tạo thông qua dịch vụ Kiểm soát Phiên bản dựa trên SVN cục bộ của bản cài đặt Enterprise Server.
Đồng bộ hóa người dùng giữa Enterprise Server và VCS
Khi một người dùng mới cho Workspace được tạo, thông tin đăng nhập đã định nghĩa (User Name và Password) của người dùng đó được lưu trữ cả trong cơ sở dữ liệu của Enterprise Server và dịch vụ Kiểm soát Phiên bản, vì dịch vụ Kiểm soát Phiên bản không thể truy cập trực tiếp mật khẩu từ cơ sở dữ liệu của Enterprise Server. Mật khẩu được lưu trữ trong dịch vụ Kiểm soát Phiên bản dưới dạng văn bản thuần túy (trong tệp \ProgramData\Altium\Altium365Data\Repository\passwd tệp).
Các mục trong danh sách này cung cấp quyền truy cập vào kho lưu trữ SVN của Enterprise Server khi làm việc với dịch vụ thông qua Altium Designer. Có thể có những trường hợp thông tin đăng nhập của người dùng không được bao gồm trong tệp, chẳng hạn như khi người dùng Workspace đã tồn tại trước khi kho lưu trữ SVN đầu tiên được tạo (thay vì ngược lại). Vấn đề này có thể được giải quyết bằng cách thêm thủ công các cặp tên/mật khẩu đó vào passwd tệp, hoặc bằng cách nhập lại mật khẩu cho từng hồ sơ người dùng trong Workspace – phương pháp thứ hai sẽ tự động cập nhật passwd tệp tương ứng mà không cần truy cập trực tiếp vào máy tính Enterprise Server.
Trong cài đặt mặc định của Enterprise Server, thông tin đăng nhập của người dùng cho dịch vụ Kiểm soát Phiên bản được lưu trữ trong tệp Passwd tệp
Xóa kho lưu trữ
Để xóa kho lưu trữ khỏi dịch vụ Kiểm soát Phiên bản của Enterprise Server, hãy nhấp vào Remove liên quan đến kho lưu trữ đó, trên VCS trang của giao diện dựa trên trình duyệt của Workspace.
Các mục kho lưu trữ bên ngoài có thể bị xóa, bất kể kho lưu trữ đó có chứa dự án nào hay không. Ngược lại, các kho lưu trữ cục bộ (những kho được tạo nội bộ thông qua dịch vụ Kiểm soát Phiên bản của Enterprise Server) không thể bị xóa nếu chúng chứa một hoặc nhiều dự án. Bạn sẽ nhận được cảnh báo về điều này và cần xóa các dự án trước khi có thể tiếp tục quá trình xóa.
Ngay cả trong trường hợp đó, nếu kho lưu trữ cục bộ không có dự án nào, nó sẽ không thực sự bị xóa, mà sẽ được chuyển sang một thư mục lưu trữ (\ProgramData\Altium\Altium365Data\RepositoryDumps, đối với cài đặt Enterprise Server mặc định). Kho lưu trữ sẽ được chứa trong một tệp Dump, kèm theo tiền tố ID duy nhất (ví dụ: 775f6c22-b9a1-468c-9f1f-4f217bb3be6b_central design repository.dump).