Dịch vụ Kiểm soát Phiên bản Cục bộ

Updated: September 01, 2022 | Applies to version: 5.5

Now reading version 5.5. For the latest, read: Dịch vụ Kiểm soát Phiên bản Cục bộ for version 7.1

Việc cài đặt Enterprise Server cung cấp khả năng kiểm soát phiên bản được bản địa hóa (và tập trung), thông qua dịch vụ Version Control. Dịch vụ này mang lại khả năng kiểm soát phiên bản ngay tại nơi bạn cần, ở môi trường cục bộ, mà không cần phải tìm kiếm hoặc trả phí cho phần mềm quản lý 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, một tổ chức có thể kiểm soát hoàn toàn những kho lưu trữ mà các nhà thiết kế của họ có thể truy cập và sử dụng.

Relevance of the information on this page:

Một bản cài đặt Enterprise Server mới cung cấp một kho lưu trữ thiết kế dựa trên Git duy nhất để chứa tất cả các dự án thiết kế Workspace của bạn – và chỉ vậy! Điều này giúp tránh mọi thiết lập và độ phức tạp liên quan đến dịch vụ Version Control cục bộ của Enterprise Server. Bạn có một kho lưu trữ thiết kế duy nhất – Versioned Storage – để tất cả các nhà thiết kế của bạn truy cập và phát hành vào đó. Vì vậy, trang VCS trong giao diện trình duyệt của Workspace trở thành trang chỉ mang tính thông tin – bạn không thể thêm kho lưu trữ mới, và kho lưu trữ Git duy nhất cũng không thể bị chỉnh sửa theo bất kỳ cách nào, cũng như không thể bị xóa. Do đó, thông tin trên trang này không áp dụng cho bạn.

Nếu bạn đã nâng cấp Enterprise Server của mình từ Altium Vault 3.0 thì việc sử dụng các kho lưu trữ SVN cũng sẽ được bật, để bạn có thể tiếp tục sử dụng quy trình thiết kế trước đây (và đã được thiết lập) của mình. Trong trường hợp này, bạn có thể tiếp tục tạo kho lưu trữ thông qua dịch vụ Version Control cục bộ (chỉ SVN), hoặc kết nối tới các kho lưu trữ bên ngoài (SVN hoặc Git). Vì vậy, thông tin trên trang này vẫn phù hợp với bạn.

Important: Lưu ý rằng nếu không, nút sẽ bị làm mờ, và khả năng tạo/thêm kho lưu trữ sẽ không khả dụng.

Để biết thêm thông tin về Design Repositories và cách làm việc với chúng thông qua Altium Designer, xem Using External Version Control.

Các ưu điểm chính

Có hai ưu điểm chính khi sử dụng dịch vụ Version Control tập trung này:

Bạn có hệ thống 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ụ Version Control sẽ làm việc với phiên/ thông tin xác thực của bạn.
Các kho lưu trữ được định nghĩa thông qua Enterprise Server (thông qua trang VCS (Admin – VCS) trong giao diện Workspace trên nền trình duyệt của Enterprise Server) sẽ được tự động nạp vào Altium Designer khi đăng nhập, vì vậy người dùng không cần phải lo về URL, giao thức, mật khẩu, v.v. Mọi thứ chỉ cần được cấu hình một lần trên Enterprise Server, rồi chia sẻ với những người dùng mục tiêu khi cần.

Khi một người dùng mới cho Enterprise Server được tạo, Password đã định nghĩa cho người dùng đó sẽ được lưu trong cả Enterprise Server và dịch vụ SVN, vì dịch vụ sau không thể truy cập trực tiếp mật khẩu từ dịch vụ trước.

Tạo kho lưu trữ

Có thể tạo các kho lưu trữ thông qua dịch vụ Version Control cục bộ (chỉ SVN), hoặc kết nối tớ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 được quản lý tập trung thông qua trang VCS (Admin – VCS) trong giao diện Workspace trên nền trình duyệt, xét theo các khía cạnh:

Tên hiển thị, mô tả và đường dẫn kho lưu trữ.
Khả năng 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 vai trò trong trường hợp các kho lưu trữ được định nghĩa thông qua dịch vụ Version Control cục bộ).
Tính sẵn sàng – thêm hoặc xóa chúng một cách tập trung, thay vì để từng nhà thiết kế phải tự tạo và kết nối tới kho lưu trữ một cách độc lập.

Hai Design Repository có sẵn theo mặc định, được cung cấp bởi dịch vụ Version Control cục bộ và lần lượt có tên là DefaultRepository (một kho lưu trữ SVN) và Versioned Storage (một kho lưu trữ Git). Kho lưu trữ DefaultRepository không thể đổi tên, nhưng bạn có thể thêm mô tả cho nó, quản lý quyền truy cập của người dùng vào nó, hoặc xóa nó nếu cần. Kho lưu trữ Versioned Storage, vốn chỉ dùng cho việc lưu trữ tích hợp các dự án Workspace, không thể đổi tên, chia sẻ hoặc xóa.

Khi người dùng Altium Designer đăng nhập vào Workspace, các Design Repository mà họ có quyền truy cập sẽ tự động được thêm vào trang Data Management – Design Repositories page của hộp thoại Preferences. Lưu ý rằng danh sách này cũng sẽ bao gồm mọi kho lưu trữ "không được quản lý" đã được thêm thủ công từ trang Preferences này.

Xác định tập trung quyền truy cập vào các Design Repository của tổ chức bạn. Các kho lưu trữ có thể là nội bộ trong bản cài đặt Enterprise Server, được định nghĩa bằng dịch vụ Version Control cục bộ, hoặc là bên ngoài thông qua SVN tích hợp sẵn của Altium Designer, hay 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 trang VCS trong giao diện Workspace trên nền trình duyệt. Khi một người dùng đăng nhập vào Workspace, các Design Repository khả dụng với họ sẽ tự động được thêm vào trang Data Management – Design Repositories của hộp thoại Preferences .

Thêm kho lưu trữ

Để thêm một Design Repository, hãy nhấp vào nút nằm ở góc trên bên phải của trang. Cửa sổ Add Repository sẽ xuất hiện, hãy dùng cửa sổ này để định nghĩa kho lưu trữ.

Chỉ các kho lưu trữ loại SVN mới có thể được tạo thông qua dịch vụ Version Control cục bộ. Có thể liên kết tới các kho lưu trữ hiện có (bên ngoài), và chúng có thể là SVN hoặc Git.

Các thuộc tính cần thiết phụ thuộc vào việc bạn đang tạo kho lưu trữ mới bằng dịch vụ Version Control cục bộ, hay đang liên kết tới một kho lưu trữ bên ngoài đã tồn tại:

New – chỉ cần đặ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 tới kho lưu trữ, cùng thông tin xác thực hợp lệ (User Name, Password) để truy cập kho lưu trữ đó (nếu cần).

Khi tạo một kho lưu trữ nội bộ trong Enterprise Server, tên phải bắt đầu bằng, và có thể chứa A-Z, a-z hoặc 0-9. Dấu gạch dưới, gạch ngang và khoảng trắng được phép xuất hiện ở giữa tên. Bạn không được sử dụng các từ sau: AUX, COM1-COM9, LPT1-LPT9, CON, NUL, và PRN. Không có hạn chế đặt tên đối với kho lưu trữ bên ngoài.

Tạo một Design Repository mới dựa trên SVN thông qua dịch vụ Version Control cục bộ của Enterprise Server, hoặc liên kết tớ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 Design Repository bên ngoài đã được liên kết được phân biệt trong danh sách kho lưu trữ bằng thuộc tính External của nó được đánh dấu ().

Để chỉnh sửa các thuộc tính của một Design Repository ở giai đoạn sau, hãy nhấp vào điều khiển Edit tương ứng của nó (). Để xóa một Design Repository, hãy nhấp vào điều khiển Remove tương ứng của nó ().

Danh sách kho lưu trữ được tự động sắp xếp theo thứ tự chữ cái theo Name, trong đó các kho lưu trữ cục bộ được định nghĩa qua dịch vụ Version Control được liệt kê trước, sau đó mới đến các kho lưu trữ bên ngoài. Kho lưu trữ Versioned Storage dựa trên Git – không thể chỉnh sửa hoặc xóa – luôn xuất hiện ở đầu danh sách.

Chia sẻ kho lưu trữ

Sau khi đã tập trung hóa các Design Repository, 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ác nhà thiết kế sẽ làm việc trên thiết kế bo mạch – đều 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 đúng hơn là quản lý các quyền truy cập của nó. Để làm điều này, hãy nhấp vào điều khiển Share tương ứng của kho lưu trữ ().

Cửa sổ Manage Permissions sẽ xuất hiện, với đầy đủ các điều khiển cần thiết để chia sẻ kho lưu trữ với những người dùng khác.

Khi các Design Repository đượ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 của từng kho lưu trữ.

Các điểm cần lưu ý:

Đối với kho lưu trữ cục bộ được tạo thông qua dịch vụ Version Control của Enterprise Server (tức là không phải bên ngoài), các quyền mặc định của nó sẽ chia sẻ kho lưu trữ đó với người dùng đã tạo kho lưu trữ và vai trò Administrators. Cả hai đều có quyền truy cập Đọc/Ghi đầy đủ.
Đối với kho lưu trữ bên ngoài, mặc định nó không được chia sẻ với bất kỳ ai – kể cả người dùng đã thêm kết nối tới nó thông qua giao diện.
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 vai trò đã định nghĩa cho Enterprise Server hoặc chia sẻ công khai. Các vai trò được liệt kê sau từng người dùng riêng lẻ.
Về mặt quyền, một người dùng/vai trò có quyền truy cập Đọc/Ghi khi tùy chọn Can Write được bật (). Nếu tùy chọn này bị tắt, họ chỉ có quyền truy cập Đọc.

Be Aware: Các thiết lập quyền khi chia sẻ một kho lưu trữ thiết kế nội bộ hiện không hoạt động hoàn toàn đúng như mong đợi. Mặc dù bản thân kho lưu trữ thiết kế nội bộ có thể được chia sẻ ở chế độ chỉ đọc với một người dùng máy chủ, người dùng đó vẫn có thể tạo các dự án Workspace MỚI trong kho lưu trữ đó, và nhận được đầy đủ quyền Đọc/Ghi đối với các thư mục dự án tương ứng được tạo ra. Lưu ý rằng chức năng sai lệch này chỉ áp dụng cho các dự án Workspace mới và các thư mục của chúng do chính người dùng đó tạo. Người dùng sẽ không có quyền Ghi với các thư mục khác trong kho lưu trữ.

Để xóa một người dùng/vai trò hiện có khỏi quyền truy cập chia sẻ vào kho lưu trữ, hãy nhấp vào điều khiển Remove tương ứng ().

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 điều khiển Add User trong cửa sổ Manage Permissions.

Trong cửa sổ Add Users xuất hiện, bắt đầu nhập họ 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 trường Select Users to be added để bật lên 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óa ở bên phải tên của họ.

Đặt quyền cho người dùng bằng trường Permission. Dùng danh sách thả xuống để chọn giữa quyền truy cập Read hoặc quyền truy cập Read/Write.

Nhấp vào nút để xác nhận việc thêm người dùng và quay lại cửa sổ Manage Permissions.

Nhấp vào nút trong cửa sổ Manage Permissions.

Để chỉnh sửa quyền cho một người dùng hiện có, hãy dùng tùy chọn Can Write trong cửa sổ Manage Permissions để chuyển đổi giữa quyền truy cập Đọc/Ghi (bật) hoặc chỉ Đọc (tắt).

Chia sẻ một Repository cục bộ với một Nhóm Vai trò đã xác định

Nếu repository được tạo thông qua dịch vụ Version Control cục bộ, thay vì repository bên ngoài, thì bạn cũng có thể chia sẻ với các nhóm Vai trò được định nghĩa cho Workspace của mình. Để chia sẻ một repository cục bộ (không phải bên ngoài) với một nhóm vai trò khác:

Nhấp vào điều khiển Add Group trong cửa sổ Manage Permissions.

Trong cửa sổ Add Groups xuất hiện, bắt đầu nhập tên của một nhóm vai trò vào trường Select Groups to be added để hiện danh sách các vai trò khớp. Chọn vai trò cần dùng từ danh sách này. Có thể chọn nhiều vai trò. Để xóa một vai trò, nhấp vào dấu xóa ở bên phải tên của vai trò đó.

Thiết lập quyền cho (các) nhóm vai trò bằng trường Permission. Dùng danh sách thả xuống để chọn giữa quyền truy cập Read hoặc Read/Write.

Nhấp nút để xác nhận việc thêm vai trò và quay lại cửa sổ Manage Permissions.

Nhấp nút trong cửa sổ Manage Permissions.

Để chỉnh sửa quyền cho một vai trò hiện có, hãy dùng tùy chọn Can Write trong cửa sổ Manage Permissions để chuyển đổi giữa quyền truy cập Đọc/Ghi (bật) hoặc chỉ Đọc (tắt).

Chia sẻ một Repository cục bộ với tất cả người dùng

Nếu repository được tạo thông qua dịch vụ Version Control cục bộ, thay vì repository bên ngoài, thì bạn cũng có thể chia sẻ repository đó với tất cả người dùng Workspace. Để chia sẻ một repository 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 điều khiển Add Anyone trong cửa sổ Manage Permissions.

Mục Anyone 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 nút trong cửa sổ Manage Permissions.

Để chỉnh sửa quyền cho thực thể Anyone, hãy dùng tùy chọn Can Write trong cửa sổ Manage Permissions để chuyển đổi giữa quyền truy cập Đọc/Ghi (bật) hoặc chỉ Đọc (tắt).

Chia sẻ một Repository bên ngoài với một Người dùng Workspace

Để chia sẻ một repository bên ngoài với một người dùng Workspace:

Nhấp vào điều khiển Add User trong cửa sổ Manage Permissions.

Trong cửa sổ Add Users xuất hiện, bắt đầu nhập họ 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 trường Select Users to be added để hiện danh sách các người dùng khớp. Chọn người dùng cần dùng từ danh sách này. Để xóa người dùng, nhấp vào dấu xóa ở bên phải tên của họ.
Trong trường SVN User, nhập một tên đã được đăng ký với repository 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 tương ứng của người dùng đã đăng ký với repository

Nhấp nút để xác nhận việc thêm người dùng và quay lại cửa sổ Manage Permissions. Nhấp Add User để thêm người dùng khác như mô tả ở bước 2 bên trên. Lưu ý rằng trong hình ví dụ thứ hai bên dưới, người dùng Barry đã được thiết lập để dùng tên repository tương ứng của anh ấy là BarrySmith, thay vì tên chung ServerAdmin.

Nhấp nút trong cửa sổ Manage Permissions.

Người dùng Workspace có thể được ánh xạ tới bất kỳ tên người dùng hợp lệ nào trong repository SVN bên ngoài, và nhiều người dùng Workspace có thể được ánh xạ tới một tên người dùng duy nhất trong repository SVN bên ngoài.

Bản thân quyền truy cập (theo dạng chỉ Đọc hoặc Đọc/Ghi) cuối cùng được quyết định bởi cài đặt của repository bên ngoài. Enterprise Server không ảnh hưởng đến việc phân quyền người dùng của repository bên ngoài, vì vậy không thể quản lý các quyền này từ phía Enterprise Server.
Khi truy cập repository bên ngoài của Enterprise Server từ Altium Designer, chẳng hạn khi tạo một project mới, có thể sẽ được yêu cầu cung cấp thông tin xác thực kết nối repository nếu việc này chưa được thực hiện trước đó. Các thông tin xác thực này sẽ được tự động sử dụng cho các hoạt động tiếp theo với repository này.

Truy cập bên ngoài tới một SVN Design Repository cục bộ

Một Design Repository được tạo thông qua Dịch vụ Version Control cục bộ của Enterprise Server có thể được truy cập bằng một trình 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 (hiện đang hỗ trợ svn://). Địa chỉ repository chính xác có thể được truy cập/sao chép từ hai vị trí:

Trang VCS của giao diện trình duyệt Workspace – trong trường Repository Path của repository đích.

Một repository 'nội bộ' được tạo từ Enterprise Server sẽ hiển thị đường dẫn địa chỉ tương đối theo Enterprise Server, tức là địa chỉ localhost của máy chủ host.

Từ bên trong Altium Designer, từ trang Data Management – Design Repositories của hộp thoại Preferences – trong trường Repository của repository đích.

Xét từ góc nhìn của Altium Designer – hoặc bất kỳ ứng dụng nào không chạy trên máy host của Enterprise Server – các đường dẫn địa chỉ repository dựa trên tên của các máy host tương ứng.

Địa chỉ hiển thị sẽ phụ thuộc vào việc bạn đang truy cập repository từ cùng máy cài đặt Enterprise Server (svn://localhost/<RepositoryName>) hay từ một PC từ xa (svn://<ComputerName>/<RepositoryName>, trong đó ComputerName là tên của PC nơi Enterprise Server đang chạy).

Hãy dùng địa chỉ đã lấy được trong chức năng duyệt repository của trình khách Subversion. Ở lần truy cập đầu tiên, một hộp thoại Authentication trung gian sẽ mở ra để yêu cầu thông tin xác thực kết nối hợp lệ. Nhập tên và mật khẩu của một tài khoản người dùng Workspace để tiếp tục. Các thông tin xác thực này hợp lệ nếu:

Tài khoản người dùng đã được thêm after repository được tạo trong Enterprise Server. Những người dùng áp dụng cho các repository đã tạo có thể xem trong tệp passwd nằm trong thư mục \ProgramData\Altium\Altium365Data\Repository trên PC của Enterprise Server – xem bên dưới.
Repository đã đượ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 lệnh Add User trong cửa sổ Manage Permissions for <repository name> của server. Điều này có thể thấy trong tệp authz của repository, nằm trong thư mục \ProgramData\Altium\Altium365Data\Repository trên PC của Enterprise Server.

Duyệt nội dung của một Design Repository được tạo thông qua dịch vụ Version Control cục bộ dựa trên SVN của bản cài đặt Enterprise Server.

Một Design Repository được tạo thông qua dịch vụ Version Control cục bộ sẽ có dữ liệu nội bộ được lưu trong một thư mục con tương ứng trong thư mục \ProgramData\Altium\Altium365Data\Repository (đối với cài đặt mặc định của Enterprise Server). Khuyến nghị không nên thay đổi hoặc chỉnh sửa các tệp trong thư mục này, ngoại trừ nhân sự IT cho mục đích bảo trì.

Đồng bộ người dùng Enterprise Server & VCS

Khi một người dùng mới cho Workspace được tạo, các thông tin xác thực đã định nghĩa (User Name và Password) của người dùng đó được lưu trong cả cơ sở dữ liệu của Enterprise Server và dịch vụ Version Control, vì dịch vụ sau không thể truy cập trực tiếp mật khẩu từ dịch vụ trước. Mật khẩu được lưu trong dịch vụ Version Control ở định dạng văn bản thuần (trong tệp \ProgramData\Altium\Altium365Data\Repository\passwd).

Các mục trong danh sách này cung cấp quyền truy cập vào repository 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 xác thực của người dùng không có trong tệp, chẳng hạn khi người dùng Workspace đã tồn tại trước khi repository SVN đầu tiên được tạo ra (thay vì ngược lại). Việc này có thể được xử lý bằng cách thêm thủ công các cặp tên/mật khẩu đó vào tệp passwd, hoặc nhập lại mật khẩu cho từng hồ sơ người dùng trong Workspace – cách sau sẽ điền vào tệp passwd tương ứng mà không cần truy cập trực tiếp vào PC của Enterprise Server.

Trong cài đặt mặc định của Enterprise Server, thông tin xác thực người dùng được lưu cho dịch vụ Version Control trong tệp Passwd tương ứng.

Xóa một Repository

Để xóa một repository khỏi dịch vụ Version Control của Enterprise Server, nhấp vào điều khiển Remove () liên kết với repository đó, trên trang VCS của giao diện Workspace trên trình duyệt.

Lưu ý rằng việc xóa một repository khỏi trang Data Management – Design Repositories của hộp thoại Preferences trong Altium Designer chỉ xóa repository đó khỏi việc được sử dụng bởi phiên bản Altium Designer đó. Thao tác này không xóa repository khỏi dịch vụ Version Control của Enterprise Server. Nếu bạn đăng xuất khỏi Enterprise Server rồi đăng nhập lại, repository sẽ xuất hiện trở lại trong danh sách các repository khả dụng của phiên bản Altium Designer đó.

Các mục repository bên ngoài có thể bị xóa bất kể repository đó có chứa project hay không. Mặt khác, repository cục bộ (những repository được tạo nội bộ thông qua dịch vụ Version Control của Enterprise Server) sẽ không thể bị xóa nếu chúng chứa một hoặc nhiều project. Bạn sẽ được thông báo về điều này và cần xóa các project trước khi có thể tiếp tục thao tác xóa.

Ngay cả khi đó, nếu một repository cục bộ không có project nào, nó cũng sẽ không thực sự bị xóa mà thay vào đó được chuyển tới một thư mục lưu trữ (\ProgramData\Altium\Altium365Data\RepositoryDumps, đối với cài đặt Enterprise Server mặc định). Repository sẽ nằm trong một tệp Dump, với tiền tố Unique ID (ví dụ: 775f6c22-b9a1-468c-9f1f-4f217bb3be6b_central design repository.dump).

Phiên bản thân thiện với máy in

Bản địa hóa bằng AI

Nếu bạn phát hiện vấn đề, hãy chọn văn bản/hình ảnh và nhấnCtrl + Enterđể gửi phản hồi cho chúng tôi.