Przejdź do głównej zawartości

Obsługa wielu wersji obrazu archITekta na jednej maszynie

W przypadku rozwijania jednocześnie wielu projektów może zdarzyć się potrzeba manualnego zarządzania wersjami platformy używanymi w poszczególnych projektach i precyzyjnego określania czasu kiedy dany projekt chcemy zaktualizować na nowszą wersję platformy (a często również dokładnego wskazania do której wersji konkretny projekt chcemy zaktualizować). W tym celu archITekt udostępnia mechanizm instalacji wydań „zamrożonych".

Wersjonowanie architekta (standardowe i wydania „zamrożone")​

Instalator platformy dostępny jest w dwóch gałęziach:

  • Domyślnej – umożliwiającej automatyczną aktualizację do nowszych wydań
  • Zamrożonej – dającej możliwość zainstalowania obok wersji domyślnej również konkretnych wydań platformy.

Platforma archITekt jest wersjonowana. Dane odnośnie konkretnej wersji są zapisane:

  • w pliku version.json znajdującym się w katalogu instalacyjnym platformy, w polu version (np. version: 21.21.60518.1545),
  • w pliku project.json znajdującym się w katalogu konkretnego projektu, w polu ArchITektVersion (np. ArchITektVersion: 21.20.60325.1643)

Wersja archITekta ma zakodowany czas kiedy została wydana zgodnie ze schematem [aa.bb].[yMMdd.HHmm], gdzie:

  • aa.bb – numer wydania wersji
  • yMMdd.HHmm – data i godzina wydania wersji

Na przykład wersja 21.20.60325.1643 oznacza wydanie 21.20 zbudowane 2026-03-25 o godzinie 16:43.

Instalacja wersji zamrożonych​

W celu instalacji konkretnej wersji zamrożonej należy skorzystać z bezpośredniego linku umożliwiającego pobranie instalatora wersji zamrożonej dla danego, konkretnego wydania. Przykładowo dla wersji 21.20.60325.1643 instalator wersji zamrożonej należy pobrać z lokalizacji:

https://architekt.vsoft.pl/download/644ad18a-9624-492c-948e-147402b017ef/21.20.60325.1643/VSoft.archITekt.21_21.20.60325.1643.msi
https://architekt.vsoft.pl/download/644ad18a-9624-492c-948e-147402b017ef/21.20.60325.1643/VSoft.archITekt.21_21.20.60325.1643.MySqlPlugin.msi

Po instalacji wersja zamrożona domyślnie będzie umieszczona w katalogu „obok" wersji standardowej:

image

Manualne zarządzanie wersjami platformy w projekcie​

Wersję archITekta dla konkretnego projektu można zamrozić:

  • już na etapie tworzenia projektu, uruchamiając skrypt tworzący projekt z katalogu zawierającego zamrożoną wersję oraz dodając parametr -LockedImageVersion 'On'
cd "C:\Program Files\VSoft\archITekt\Images\21_21.20.60325.1643"
.\DeveloperCreate.ps1 [...] -LockedImageVersion 'On'

lub

.\OnPremisesCreate.ps1 [...] -LockedImageVersion 'On'
  • lub zamrażając wersję już istniejącego projektu:
# zamrożenie wersji
.\Reconfigure.ps1 -pathProjectFolder [katalog projektu] -LockedImageVersion 'On'

# odmrożenie wersji
.\Reconfigure.ps1 -pathProjectFolder [katalog projektu] -LockedImageVersion 'Off'

W przypadku zamrożenia wersji projektu, wszystkie skrypty administracyjne będą automatycznie „przekierowywane" i wywoływane na konkretnej wersji platformy. Będzie można to zaobserwować w konsoli:

image

Procedura ręcznej aktualizacji projektu do wskazanej wersj​

Poniżej przedstawiony jest przykład aktualizacji projektu do konkretnej, wskazanej wersji platformy, przy wykorzystaniu mechanizmu „zamrożonych" wersji.

Załóżmy, że posiadamy projekt w wersji 21.20.60318.1053, mający włączoną flagę LockedImageVersion: On i chcemy go zaktualizować do konkretnej wersji np. 21.20.60325.1643.

  1. Wyłączamy zamrożenie projektu. (Uwaga! Skrypt automatycznie przekieruje wykonanie do skryptu z odpowiedniej wersji – ze względu na status „zamrożony" projektu)
.\Reconfigure.ps1 -pathProjectFolder '(katalog projektu)' -LockedImageVersion Off
  1. Uruchamiamy skrypt podbijający projekt z katalogu wersji, do której chcemy podbić projekt.

Dla środowiska deweloperskiego:

cd 'c:\Program Files\VSoft\archITekt\Images\21_21.20.60325.1643'
.\InstallDeveloper.ps1 -PathProjectFolder '(katalog projektu)' -SetupCommand Upgrade

Lub dla środowiska OnPremises:

cd 'c:\Program Files\VSoft\archITekt\Images\21_21.20.60325.1643'
.\InstallOnPremises.ps1 -PathProjectFolder '(katalog projektu)' -SetupCommand ClusterInstallOrUpdate
  1. Zamrażamy wersję obrazu w środowisku (wykonując skrypt z obrazu zamrożonego):
cd 'c:\Program Files\VSoft\archITekt\Images\21_21.20.60325.1643'
.\Reconfigure.ps1 -pathProjectFolder '(katalog projektu)' -LockedImageVersion On

Po zakończeniu wykonania procedury projekt będzie zaktualizowany do wersji 21.20.60325.1643

Zobacz również​

Blokowanie projektu - zamrażanie wersji