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.
Kiedy używać
Dział zatytułowany „Kiedy używać”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.
Utwórz połączenie PlaidCloud Git
Dział zatytułowany „Utwórz połączenie PlaidCloud Git”- Otwórz Tools > Connections
- Kliknij
New Connectioni wybierz z menu PlaidCloud Git - 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 repozytoriumudfslubapps). 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
- Ustaw Użycie —
Active, aby włączyć połączenie, orazRead Only, jeśli połączenie nigdy nie powinno zapisywać - Ustaw Model zabezpieczeń — określa, kto w obszarze roboczym może używać połączenia
- 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.
Model zabezpieczeń
Dział zatytułowany „Model zabezpieczeń”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.
Kto widzi repozytoria
Dział zatytułowany „Kto widzi repozytoria”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.
Zaawansowane: repozytoria prywatne
Dział zatytułowany „Zaawansowane: repozytoria prywatne”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ć.
- Wypchnij aplikację do repozytorium na serwerze PlaidCloud Git obszaru roboczego — plik
.pypunktu wejścia (w Panel wywołuje.servable(); w Dash udostępniaserver = app.server) oraz opcjonalny plikrequirements.txtw 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. - Utwórz połączenie PlaidCloud Git, w którym Repozytorium wskazuje to repozytorium, zgodnie z powyższymi krokami.
- 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ć
- 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.
Powiązane
Dział zatytułowany „Powiązane”- Wdrażanie aplikacji Panel z PlaidCloud Git — pełna ścieżka od repozytorium do udostępnionej aplikacji.
- Wdrażanie aplikacji Dash z PlaidCloud Git — ta sama ścieżka dla aplikacji Plotly Dash.
- Tworzenie połączeń i zarządzanie nimi — wspólny formularz, środowiska, testowanie i kontrola dostępu.
- Tworzenie aplikacji Panel — publikowanie i przebudowa serwerowej aplikacji Panel z gałęzi Git.
- PlaidCloud Git — wbudowana usługa Git obszaru roboczego.
- Połączenia z repozytoriami Git — zewnętrzni dostawcy Git i ich pełne formularze połączeń.