Przejdź do głównej zawartości

Połączenie PlaidCloud Git

Połączenie PlaidCloud Git kieruje przepływ pracy — lub kompilację aplikacji Server Panel — do repozytorium na własnym zarządzanym serwerze Git obszaru roboczego. Ponieważ ten serwer Git jest hostowany dla Ciebie pod adresem git.<your-workspace>.plaid.cloud, a Ty jesteś już zalogowany(-a) przez zwykłe logowanie do PlaidCloud, formularz połączenia jest znacznie prostszy niż w przypadku zewnętrznego dostawcy Git: nie trzeba wpisywać adresu URL serwera ani zarządzać nazwą użytkownika, tokenem czy kluczem SSH.

Użyj połączenia PlaidCloud Git zawsze wtedy, gdy repozytorium, z którego chcesz czytać, znajduje się w PlaidCloud Git — wbudowanej usłudze Git obszaru roboczego — a nie u zewnętrznego dostawcy. Najczęściej służy to do automatyzacji kompilacji serwerowych aplikacji Panel lub aplikacji Dash z zarządzanego repozytorium, dzięki czemu wypchnięcie zmian do gałęzi powoduje ponowne zbudowanie i wdrożenie aplikacji bez zewnętrznego konta GitHub ani osobistego tokenu dostępu.

W przypadku repozytorium hostowanego w usłudze zewnętrznej — GitHub, GitLab, Bitbucket, Forgejo lub Gitea — użyj zamiast tego zewnętrznego połączenia Git. Zachowuje ono pełny formularz z polem Server URL, uwierzytelnianiem przez użytkownika i token lub SSO oraz kartami SSL i SSH.

  1. Otwórz Tools > Connections
  2. Kliknij New Connection i wybierz z menu PlaidCloud Git
  3. Wypełnij uproszczony formularz:
    • Nazwa konta — wyświetlana nazwa połączenia
    • Notatka — opcjonalna notatka o przeznaczeniu połączenia
    • Repozytorium — kliknij Refresh, aby wyświetlić repozytoria dostępne dla obszaru roboczego, a następnie wybierz jedno z nich (na przykład repozytorium udfs lub apps). Wybierasz z listy, zamiast wpisywać ścieżkę.
    • Domyślna gałąź — wybierz gałąź, z której domyślnie ma być odczyt, z listy gałęzi w wybranym repozytorium
    • Ścieżka początkowa — opcjonalnie przejrzyj repozytorium i wybierz folder, aby ograniczyć każde wyszukiwanie plików do podfolderu; pozostaw nieustawioną, aby użyć całego repozytorium
  4. Ustaw Użycie — Active, aby włączyć połączenie, oraz Read Only, jeśli połączenie nigdy nie powinno zapisywać
  5. Ustaw Model zabezpieczeń — określa, kto w obszarze roboczym może używać połączenia
  6. Kliknij Create, aby zapisać

To cały formularz. W przeciwieństwie do zewnętrznego dostawcy Git nie ma tu adresu URL serwera, karty uwierzytelniania ani konfiguracji SSL czy SSH — wszystko to jest obsługiwane automatycznie.

Opcja Security Model określa, kto w obszarze roboczym może używać połączenia:

Opcja Kto może używać połączenia
Prywatne (tylko właściciele) Wyłącznie właściciele.
Tylko wybrani członkowie Właściciele oraz jawnie wskazana lista członków.
Tylko wybrane grupy zabezpieczeń Właściciele oraz członkowie wskazanych grup zabezpieczeń.
Wszyscy członkowie obszaru roboczego Wszyscy w obszarze roboczym.

W przypadku opcji Specific Members Only lub Specific Security Groups Only nadaj dostęp z menu Actions na liście po zapisaniu. Wspólne mechanizmy połączeń opisano w Tworzenie połączeń i zarządzanie nimi.

Każde repozytorium utworzone dla Ciebie przez PlaidCloud jest czytelne dla każdego zalogowanego członka obszaru roboczego. Dotyczy to repozytoriów aplikacji Panel i Dash oraz wbudowanych repozytoriów apps i udfs. Osoby niezalogowane nie mogą ich czytać.

Dzięki temu członkowie mogą otwierać i ponownie publikować aplikacje oraz wybierać repozytorium dla połączenia PlaidCloud Git bez konfiguracji poszczególnych repozytoriów.

Administrator Git może ustawić repozytorium jako prywatne w interfejsie Git. Takie repozytorium nie jest już widoczne dla każdego członka, w związku z czym:

  • Nie pojawia się na liście Repozytorium w połączeniach PlaidCloud Git.
  • Nie można z niego odczytać kodu UDF opartego na Git, więc UDF oparty na Git, przechowywany w repozytorium prywatnym, nie zostanie uruchomiony.
  • Członkowie nie mogą z niego opublikować aplikacji.

Aby użyć repozytorium prywatnego jako źródła, utwórz zamiast tego zewnętrzne połączenie Git z własnym tokenem dostępu.

Automatyzacja kompilacji aplikacji Panel i Dash z zarządzanego Git

Dział zatytułowany „Automatyzacja kompilacji aplikacji Panel i Dash z zarządzanego Git”

Serwerowa aplikacja Panel lub aplikacja Dash jest budowana z gałęzi Git i automatycznie przebudowywana po każdym wypchnięciu zmian do tej gałęzi. Skierowanie jej na połączenie PlaidCloud Git utrzymuje całą pętlę wewnątrz obszaru roboczego — bez zewnętrznego hosta i bez osobistego tokenu dostępu, który trzeba odnawiać.

  1. Wypchnij aplikację do repozytorium na serwerze PlaidCloud Git obszaru roboczego — plik .py punktu wejścia (w Panel wywołuje .servable(); w Dash udostępnia server = app.server) oraz opcjonalny plik requirements.txt w katalogu głównym repozytorium lub obok punktu wejścia. Układ repozytorium opisano w Tworzenie aplikacji Panel oraz Wdrażanie aplikacji Dash z PlaidCloud Git.
  2. Utwórz połączenie PlaidCloud Git, w którym Repozytorium wskazuje to repozytorium, zgodnie z powyższymi krokami.
  3. W Aplikacje wybierz Nowa aplikacja > Oparta na serwerze lub Aplikacja Dash i w sekcji Połączenie Git i obserwator publikacji:
    • Połączenie Git — wybierz właśnie utworzone połączenie PlaidCloud Git
    • Gałąź — gałąź, z której ma być budowana aplikacja; wypchnięcia do niej powodują przebudowę i ponowne wdrożenie aplikacji
    • Punkt wejścia — plik .py, który aplikacja ma udostępniać
  4. Dokończ okno publikacji i kliknij Opublikuj.

Od tej chwili każde wypchnięcie do tej gałęzi na zarządzanym serwerze Git przebudowuje aplikację — w pełni zautomatyzowana kompilacja, która nigdy nie opuszcza PlaidCloud.