Szukaj w: Doc:Documentation: Altium On-Prem Enterprise Server
Altium DesignerAltium 365Altium MCAD CoDesignerAltium On-Prem Enterprise ServerAltium CircuitMakerAltium CircuitStudioCompany DashboardAltium Infrastructure ServerAltium Developer Center
Ver: Version: 7.1
7.17.06.05.5
Close
Szukaj Szukaj w dokumentacji

Lokalna usługa kontroli wersji

Updated: Maj 21, 2026 | Applies to version: 7.1

Instalacja Enterprise Server zapewnia lokalną (i scentralizowaną) kontrolę wersji dzięki usłudze Version Control. Usługa ta udostępnia możliwości kontroli wersji dokładnie tam, gdzie są potrzebne — lokalnie — bez konieczności szukania ani płacenia za zewnętrzne oprogramowanie do zarządzania VCS.

Dzięki definiowaniu repozytoriów projektowych w tak scentralizowany sposób organizacja może w pełni kontrolować, do których repozytoriów jej projektanci mają dostęp i z których mogą korzystać.

Relevance of the information on this page:

Nowa instalacja Enterprise Server udostępnia jedno repozytorium projektowe oparte na Git, przeznaczone do przechowywania wszystkich projektów projektowych w Workspace — i to wszystko! Eliminuje to konieczność konfiguracji oraz złożoność związaną z lokalną usługą Version Control w Enterprise Server. Masz jedno repozytorium projektowe – Versioned Storage – do którego wszyscy projektanci mają dostęp i do którego mogą publikować wydania. W związku z tym strona VCS w interfejsie przeglądarkowym Workspace ma wyłącznie charakter informacyjny — nie można dodać nowego repozytorium, a jedynego repozytorium Git nie da się w żaden sposób modyfikować ani usunąć. Informacje na tej stronie zatem Cię nie dotyczą.

Jeśli zaktualizowano Enterprise Server z wersji lub produktu serwerowego, w którym włączone było użycie repozytoriów SVN, to po aktualizacji nadal będą one włączone (upewnij się, że odświeżysz licencjonowanie Altium On-Prem Enterprise Server). Pozwala to kontynuować dotychczasowy (i ugruntowany) przepływ pracy. W takim przypadku możesz nadal tworzyć repozytoria za pomocą lokalnej usługi Version Control (tylko SVN) lub łączyć się z repozytoriami zewnętrznymi (SVN lub Git). Informacje na tej stronie są więc nadal dla Ciebie istotne.

Important: Zwróć uwagę, że w przeciwnym razie przycisk będzie wyszarzony, a możliwość tworzenia/dodawania repozytoriów będzie niedostępna.

Aby uzyskać więcej informacji o Design Repositories i pracy z nimi w Altium Designer, zobacz Using External Version Control.

Kluczowe zalety

Istnieją dwie kluczowe zalety korzystania z tej scentralizowanej usługi Version Control:

  1. Masz wspólnych użytkowników i zarządzanie uprawnieniami zarówno dla Altium Designer, jak i SVN. Po zalogowaniu do Enterprise Server usługa Version Control działa w oparciu o Twoją sesję/poświadczenia.
  2. Repozytoria zdefiniowane przez Enterprise Server (na stronie VCS (Admin – VCS) w przeglądarkowym interfejsie Workspace Enterprise Server) są automatycznie udostępniane w Altium Designer podczas logowania, dzięki czemu użytkownicy nie muszą martwić się o adresy URL, protokoły, hasła itp. Konfigurujesz to tylko raz na Enterprise Server, a następnie udostępniasz wskazanym użytkownikom zgodnie z potrzebą.
Gdy tworzony jest nowy użytkownik Enterprise Server, zdefiniowane dla niego Password jest zapisywane zarówno w Enterprise Server, jak i w usłudze SVN, ponieważ ta druga nie może bezpośrednio uzyskać dostępu do hasła z tej pierwszej.

Tworzenie repozytorium

Repozytoria można tworzyć za pomocą lokalnej usługi Version Control (tylko SVN) lub można podłączać repozytoria zewnętrzne (SVN lub Git). Łącznie wszystkie repozytoria są centralnie zarządzane na stronie VCS (Admin – VCS) w przeglądarkowym interfejsie Workspace w zakresie:

  • Ich wyświetlanej nazwy, opisu i ścieżki repozytorium.
  • Skonfigurowanej dostępności — którzy konkretni użytkownicy mogą mieć do nich dostęp (lub grupy w przypadku repozytoriów zdefiniowanych przez lokalną usługę Version Control).
  • Ich dostępności operacyjnej — dodawania lub usuwania centralnie, zamiast tego, by poszczególni projektanci musieli samodzielnie tworzyć i podłączać repozytoria.
Domyślnie dostępne są dwa Design Repositories, dostarczane przez lokalną usługę Version Control i nazwane odpowiednio DefaultRepository (repozytorium SVN) oraz Versioned Storage (repozytorium Git). Repozytorium DefaultRepository nie może zostać przemianowane, ale możesz dodać do niego opis, zarządzać dostępem użytkowników lub usunąć je — w razie potrzeby. Repozytorium Versioned Storage, które służy wyłącznie do zintegrowanego przechowywania projektów Workspace, nie może zostać przemianowane, udostępnione ani usunięte.

Gdy użytkownik Altium Designer zaloguje się do Workspace, dostępne dla niego Design Repositories zostaną automatycznie dodane na stronie Data Management – Design Repositories page w oknie dialogowym Preferences. Zwróć uwagę, że lista będzie również zawierać wszelkie „niezarządzane” repozytoria, które zostały ręcznie dodane z tej strony Preferences.

Centralnie zdefiniuj dostęp do Design Repositories w swojej organizacji. Repozytoria mogą być wewnętrzne dla instalacji Enterprise Server, zdefiniowane przy użyciu lokalnej usługi Version Control, albo zewnętrzne — poprzez wbudowaną w Altium Designer obsługę SVN lub usługi SVN/Git firm trzecich. Kontrola dostępu jest realizowana na stronie VCS w przeglądarkowym interfejsie Workspace. Gdy użytkownik zaloguje się do Workspace, dostępne dla niego Design Repositories zostaną automatycznie dodane na stronie Data Management – Design Repositories okna dialogowego Preferences .Centralnie zdefiniuj dostęp do Design Repositories w swojej organizacji. Repozytoria mogą być wewnętrzne dla instalacji Enterprise Server, zdefiniowane przy użyciu lokalnej usługi Version Control, albo zewnętrzne — poprzez wbudowaną w Altium Designer obsługę SVN lub usługi SVN/Git firm trzecich. Kontrola dostępu jest realizowana na stronie VCS w przeglądarkowym interfejsie Workspace. Gdy użytkownik zaloguje się do Workspace, dostępne dla niego Design Repositories zostaną automatycznie dodane na stronie Data Management – Design Repositories okna dialogowego Preferences .

Dodawanie repozytorium

Aby dodać Design Repository, kliknij przycisk znajdujący się w prawym górnym rogu strony. Pojawi się okno Add Repository — użyj go do zdefiniowania repozytorium.

Tylko repozytoria typu SVN mogą być tworzone za pomocą lokalnej usługi Version Control. Istniejące (zewnętrzne) repozytoria można podłączać — mogą to być repozytoria SVN lub Git.

Wymagane właściwości zależą od tego, czy tworzysz nowe repozytorium przy użyciu lokalnej usługi Version Control, czy łączysz się z istniejącym repozytorium zewnętrznym:

  • New – nadaj repozytorium nazwę i opis.
  • Existing – oprócz nazwy i opisu musisz podać URL do repozytorium oraz prawidłowe poświadczenia (User Name, Password) umożliwiające dostęp do tego repozytorium (jeśli są wymagane).
Podczas tworzenia repozytorium wewnętrznego dla Enterprise Server nazwa powinna zaczynać się od i może zawierać znaki A-Z, a-z lub 0-9. Podkreślenia, myślniki i spacje są dozwolone w środku nazwy. Nie można używać następujących słów: AUX, COM1-COM9, LPT1-LPT9, CON, NUL oraz PRN. Dla repozytorium zewnętrznego nie ma ograniczeń nazewnictwa.

Utwórz nowe repozytorium projektowe oparte na SVN za pomocą lokalnej usługi Version Control w Enterprise Server lub podłącz istniejące repozytorium (SVN lub Git), które zostało utworzone poza Enterprise Server.Utwórz nowe repozytorium projektowe oparte na SVN za pomocą lokalnej usługi Version Control w Enterprise Server lub podłącz istniejące repozytorium (SVN lub Git), które zostało utworzone poza Enterprise Server.

Podłączone, zewnętrzne Design Repository jest wyróżnione na liście repozytoriów poprzez zaznaczenie właściwości External ().

Aby później edytować właściwości Design Repository, kliknij powiązaną z nim kontrolkę Edit (). Aby usunąć Design Repository, kliknij powiązaną z nim kontrolkę Remove ().

Lista repozytoriów jest automatycznie sortowana alfabetycznie według Name; najpierw wyświetlane są repozytoria lokalne zdefiniowane przez usługę Version Control, a następnie repozytoria zewnętrzne. Repozytorium oparte na Git Versioned Storage — którego nie można modyfikować ani usunąć — zawsze pojawia się na górze listy.

Udostępnianie repozytorium

Po scentralizowaniu Design Repositories musisz upewnić się, że osoby wymagające dostępu do danego repozytorium — w tym projektanci pracujący nad projektami płytek — mają ten dostęp. Osiąga się to poprzez udostępnienie repozytorium, a dokładniej zarządzanie jego uprawnieniami dostępu. Aby to zrobić, kliknij powiązaną z repozytorium kontrolkę Share ().

Pojawi się okno Manage Permissions z wszystkimi kontrolkami niezbędnymi do udostępnienia repozytorium innym użytkownikom.

Gdy Design Repositories są centralnie uporządkowane, udostępnianie innym sprowadza się po prostu do zarządzania uprawnieniami każdego repozytorium.Gdy Design Repositories są centralnie uporządkowane, udostępnianie innym sprowadza się po prostu do zarządzania uprawnieniami każdego repozytorium.

Rzeczy, o których warto pamiętać:

  • Dla lokalnego repozytorium utworzonego przez usługę Version Control w Enterprise Server (tj. nie zewnętrznego) domyślne uprawnienia udostępniają to repozytorium użytkownikowi, który je utworzył, oraz grupie Administrators. Oba te podmioty mają pełny dostęp do odczytu/zapisu.
  • Dla repozytorium zewnętrznego domyślnie nie jest ono udostępnione nikomu — nawet użytkownikowi, który dodał do niego połączenie przez interfejs.
  • Tylko repozytoria lokalne (nie zewnętrzne) mogą być udostępniane zdefiniowanym grupom w Enterprise Server lub publicznie. Grupy są wyświetlane po użytkownikach indywidualnych.
  • W zakresie uprawnień użytkownik/grupa ma dostęp do odczytu/zapisu, gdy opcja Can Write jest włączona (). Jeśli ta opcja jest wyłączona, mają tylko dostęp do odczytu.
Be Aware: Ustawienia uprawnień podczas udostępniania wewnętrznego repozytorium projektowego nie działają dokładnie tak, jak można by oczekiwać. Mimo że samo wewnętrzne repozytorium projektowe może zostać udostępnione użytkownikowi serwera z dostępem tylko do odczytu, użytkownik ten nadal może tworzyć NOWE projekty Workspace w tym repozytorium i uzyskać pełne uprawnienia odczytu/zapisu do odpowiadających im folderów projektu, które zostaną utworzone. Zwróć uwagę, że to błędne działanie dotyczy wyłącznie nowych projektów Workspace i ich folderów tworzonych przez tego użytkownika. Użytkownik nie będzie miał uprawnień zapisu do innych folderów w repozytorium.
  • Aby usunąć istniejącego użytkownika/grupę z udostępnionego dostępu do repozytorium, kliknij powiązaną kontrolkę Remove ().

Zewnętrzny dostęp do lokalnego repozytorium projektowego SVN

Repozytorium projektowe utworzone za pośrednictwem lokalnej usługi Version Control w Enterprise Server może być dostępne przy użyciu klienta SVN, takiego jak TortoiseSVN. Dostęp odbywa się z użyciem standardowego protokołu sieciowego (obecnie obsługiwany jest svn://). Poprawny adres repozytorium można uzyskać/skopiować z dwóch miejsc:

  • Strona VCS w interfejsie przeglądarkowym Workspace – w polu Repository Path dla docelowego repozytorium.

„Wewnętrzne” repozytorium utworzone z poziomu Enterprise Server pokaże ścieżkę adresu względem Enterprise Server, czyli adres localhost komputera-hosta.„Wewnętrzne” repozytorium utworzone z poziomu Enterprise Server pokaże ścieżkę adresu względem Enterprise Server, czyli adres localhost komputera-hosta.

Z perspektywy Altium Designer – lub dowolnej aplikacji nieuruchomionej na komputerze-hoscie Enterprise Server – ścieżki adresów repozytorium są oparte na nazwie ich komputerów-hostów.Z perspektywy Altium Designer – lub dowolnej aplikacji nieuruchomionej na komputerze-hoscie Enterprise Server – ścieżki adresów repozytorium są oparte na nazwie ich komputerów-hostów.

Wyświetlany adres będzie zależał od tego, czy uzyskujesz dostęp do repozytorium z tej samej maszyny, na której zainstalowano Enterprise Server (svn://localhost/<RepositoryName>), czy z komputera zdalnego (svn://<ComputerName>/<RepositoryName>, gdzie ComputerName to nazwa komputera, na którym znajduje się Enterprise Server).

Użyj uzyskanego adresu w funkcji przeglądania repozytorium w kliencie Subversion. Przy pierwszym dostępie otworzy się pośrednie okno dialogowe Authentication z prośbą o prawidłowe poświadczenia połączenia. Aby kontynuować, wprowadź nazwę i hasło konta użytkownika Workspace. Te poświadczenia są prawidłowe, jeśli:

  • Konto użytkownika zostało dodane after repozytorium zostało utworzone w Enterprise Server. Użytkowników, których to dotyczy w przypadku utworzonych repozytoriów, można zobaczyć w pliku passwd znajdującym się w folderze \ProgramData\Altium\Altium365Data\Repository na komputerze Enterprise Server – patrz poniżej.
  • Repozytorium zostało udostępnione temu kontu użytkownika poprzez dodanie tej nazwy użytkownika za pomocą polecenia Add User w oknie Manage Permissions for <repository name> serwera. Jest to widoczne w pliku authz repozytorium, znajdującym się w folderze \ProgramData\Altium\Altium365Data\Repository na komputerze Enterprise Server.

Przeglądanie zawartości repozytorium projektowego utworzonego przez lokalną usługę Version Control opartą na SVN w instalacji Enterprise Server.Przeglądanie zawartości repozytorium projektowego utworzonego przez lokalną usługę Version Control opartą na SVN w instalacji Enterprise Server.

Repozytorium projektowe utworzone za pośrednictwem lokalnej usługi Version Control ma swoje dane wewnętrzne przechowywane w odpowiadającym mu podfolderze w folderze \ProgramData\Altium\Altium365Data\Repository (dla domyślnej instalacji Enterprise Server). Zaleca się, aby pliki w tym folderze nie były zmieniane ani edytowane, poza działaniami konserwacyjnymi wykonywanymi przez personel IT.

Enterprise Server & synchronizacja użytkowników VCS

Gdy tworzony jest nowy użytkownik dla Workspace, zdefiniowane poświadczenia (User Name i Password) dla tego użytkownika są zapisywane zarówno w bazie danych Enterprise Server, jak i w usłudze Version Control, ponieważ ta druga nie może bezpośrednio uzyskać hasła z tej pierwszej. Hasło jest przechowywane w usłudze Version Control w formacie jawnym (w pliku \ProgramData\Altium\Altium365Data\Repository\passwd).

Wpisy na tej liście zapewniają dostęp do repozytorium SVN Enterprise Server podczas pracy z usługą przez Altium Designer. Mogą zdarzyć się sytuacje, w których poświadczenia użytkownika nie są uwzględnione w pliku, na przykład gdy użytkownicy Workspace już istnieją w momencie tworzenia pierwszego repozytorium SVN (a nie odwrotnie). Można to rozwiązać, ręcznie dodając te pary nazwa/hasło do pliku passwd lub ponownie wprowadzając hasło dla profilu każdego użytkownika w Workspace – to drugie podejście uzupełni odpowiednio plik passwd i nie będzie wymagało bezpośredniego dostępu do komputera Enterprise Server.

W domyślnej instalacji Enterprise Server poświadczenia użytkowników są przechowywane dla usługi Version Control w powiązanym pliku Passwd.W domyślnej instalacji Enterprise Server poświadczenia użytkowników są przechowywane dla usługi Version Control w powiązanym pliku Passwd.

Usuwanie repozytorium

Aby usunąć repozytorium z usługi Version Control w Enterprise Server, kliknij element sterujący Remove () powiązany z tym repozytorium na stronie VCS w przeglądarkowym interfejsie Workspace.

Zwróć uwagę, że usunięcie repozytorium ze strony Data Management – Design Repositories w oknie dialogowym Preferences w Altium Designer usuwa to repozytorium jedynie z użycia w tej instancji Altium Designer. Nie usuwa repozytorium z usługi Version Control w Enterprise Server. Jeśli wylogujesz się z Enterprise Server i zalogujesz ponownie, repozytorium ponownie pojawi się na liście dostępnych repozytoriów dla tej instancji Altium Designer.

Wpisy repozytoriów zewnętrznych można usuwać niezależnie od tego, czy repozytorium zawiera jakiekolwiek projekty. Z kolei repozytoria lokalne (te utworzone wewnętrznie przez usługę Version Control w Enterprise Server) nie mogą zostać usunięte, jeśli zawierają jeden lub więcej projektów. Zostaniesz o tym poinformowany i przed kontynuowaniem usuwania należy najpierw usunąć projekty.

Nawet wtedy, jeśli lokalne repozytorium nie ma projektów, nie zostanie ono faktycznie usunięte, lecz przeniesione do katalogu archiwum (\ProgramData\Altium\Altium365Data\RepositoryDumps, dla domyślnej instalacji Enterprise Server). Repozytorium będzie zawarte w pliku Dump z prefiksem unikalnego identyfikatora (np. 775f6c22-b9a1-468c-9f1f-4f217bb3be6b_central design repository.dump).

AI-LocalizedTłumaczenie SI
Jeśli znajdziesz błąd, zaznacz tekst/obraz i naciśnij Ctrl + Enter aby wysłać nam wiadomość.
Content