Agenci PlaidLink

Opis

Czasami konieczny i pożądany jest dostęp do danych lub uruchamianie procesów z systemu zdalnego, który nie dopuszcza dostępu z zewnątrz. Jest to typowe w środowiskach korporacyjnych za zaporą sieciową. PlaidCloud umożliwia to za pomocą PlaidLink, który zapewnia dostęp do systemów zdalnych za zaporą sieciową lub tam, gdzie bezpośredni dostęp z PlaidCloud jest niepożądany.

PlaidLink wykorzystuje system oparty na agentach. Oznacza to, że agent, czyli zdalny użytkownik, jest instalowany w systemie wewnątrz zapory sieciowej lub innego obszaru o ograniczonym dostępie. Agent może następnie połączyć się z PlaidCloud, inicjując połączenie wychodzące przez bezpieczne połączenie websocket HTTPS. Jest to tak samo bezpieczne jak każde inne szyfrowane połączenie internetowe i zwykle nie wymaga otwierania niestandardowych portów. Zanim agent uzyska dostęp, musi się zidentyfikować, wysyłając swój identyfikator agenta. Jeśli proces uwierzytelniania agenta zakończy się powodzeniem, agent otrzymuje dostęp do zatwierdzonych operacji.

PlaidLink można zainstalować w systemach Windows, Unix i Linux, a także uruchamiać z uprawnieniami użytkowników o niskich przywilejach. W systemach Windows PlaidLink może działać jako usługa systemu Windows z pełną kontrolą z poziomu panelu usług. W systemach Linux lub Unix może działać jako proces demona.

PlaidLink może również działać jako samodzielny kontener Docker lub pod Kubernetes.

Zarządzanie agentami

Aby zarządzać agentami:

1. Otwórz Analyze
2. Wybierz „Tools”
3. Kliknij „Agenci PlaidLink”

Spowoduje to przejście do tabeli agentów PlaidLink, w której możesz wyświetlać listę dostępnych agentów, modyfikować ją i uzyskiwać poświadczenia.

Tworzenie agenta

Aby utworzyć agenta:

1. Otwórz Analyze
2. Wybierz „Tools”
3. Kliknij „Agenci PlaidLink”
4. Kliknij „Dodaj agenta PlaidLink”
5. Wypełnij wymagane pola
6. Kliknij „Create”
7. Przypisz agenta do grup zabezpieczeń niezbędnych do uzyskania dostępu do zasobów potrzebnych do wykonywania jego zadań
8. Przypisz agenta do kont dokumentów niezbędnych do uzyskania dostępu do dokumentów potrzebnych do wykonywania jego zadań

Ważne

W krokach 7 i 8 powyżej agent PlaidLink musi zostać przypisany do grup zabezpieczeń i kont dokumentów niezbędnych do wykonywania zadań, których od niego oczekujesz. W przeciwnym razie dostęp zostanie mu odmówiony.

Notatka

Wszystkie informacje, których nie ma w formularzu nowego agenta, zostaną wygenerowane automatycznie.

Uzyskiwanie poświadczeń agenta

Aby skonfigurować agentów PlaidLink w systemie zdalnym, musisz najpierw uzyskać informacje identyfikujące agenta, co jest niezbędne do zachowania bezpieczeństwa. Informacje te obejmują klucz publiczny i klucz prywatny.

Aby uzyskać te klucze:

1. Otwórz Analyze
2. Wybierz „Tools”
3. Kliknij „Agenci PlaidLink”
4. Kliknij ikonę edycji

Spowoduje to otwarcie formularza, w którym możesz wyświetlić wartości klucza publicznego i prywatnego.

Ponowne generowanie poświadczeń agenta

Warto okresowo ponownie generować klucz publiczny i prywatny oraz aktualizować konfigurację systemów zdalnych, aby zachować bezpieczeństwo.

Aby ponownie wygenerować poświadczenia:

1. Otwórz Analyze
2. Wybierz „Tools”
3. Kliknij „Agenci PlaidLink”
4. Kliknij ikonę ponownego generowania

Po ponownym wygenerowaniu poświadczeń można je uzyskać w ten sam sposób, co poświadczenia nowego agenta (opisany powyżej).

Włączanie i wyłączanie agenta

Aby wyłączyć agenta:

1. Otwórz Analyze
2. Wybierz „Tools”
3. Kliknij „Agenci PlaidLink”
4. Odznacz pole wyboru „Active”

Notatka

Gdy agent nie jest oznaczony jako aktywny, systemy zdalne nie będą mogły się łączyć przy użyciu poświadczeń tego agenta

Środowiska agentów

Połączenie może mieć inną konfigurację dla każdego środowiska, więc przełączenie środowiska projektu zmienia jednocześnie cel wszystkich używanych przez niego połączeń. Agenci mogą podążać za tym samym przełączeniem.

Każdy agent ma dwa ustawienia:

• Grupa agentów — nazwa wspólna dla agentów, którzy się nawzajem zastępują. Agenci w grupie są alternatywami do tej samej pracy, po jednym na środowisko.
• Środowisko — któremu środowisku połączeń służy ten agent.

Krok nadal wskazuje jednego konkretnego agenta. Gdy przepływ pracy jest uruchamiany, PlaidCloud sprawdza grupę, do której należy ten agent, i wybiera członka obsługującego bieżące środowisko projektu. Dzięki temu projekt przeniesiony ze środowiska domyślnego do QA uruchamia swoje kroki zdalne na maszynie QA, bez edytowania żadnego kroku.

Dla grupy o nazwie Finance z jednym agentem obsługującym środowisko Default i drugim obsługującym QA krok wskazujący któregokolwiek z nich uruchamia się na tym, który pasuje do projektu — a projekt przełączony z powrotem na Default uruchamia się na agencie Default, nawet jeśli krok wskazuje agenta QA.

Aby przypisać agenta do środowiska:

1. Otwórz Analyze
2. Wybierz „Tools”
3. Kliknij „Agenci PlaidLink”
4. Otwórz agenta
5. Ustaw „Grupa agentów” na nazwę wspólną z alternatywami agenta i ustaw „Środowisko” na środowisko, któremu ten agent służy
6. Na maszynie z tym agentem ustaw odpowiadającą nazwę środowiska w pliku konfiguracyjnym PlaidLink — zobacz Dopasowanie maszyny agenta poniżej

Notatka

Agent bez ustawionej grupy obsługuje wszystkie środowiska, czyli tak jest ze wszystkimi agentami, dopóki nie ustawisz grupy. Nic się nie zmienia w obszarze roboczym, w którym działa jeden agent.

Uwaga

Ustawienie grupy sprawia, że dopasowanie jest dokładne dla każdego agenta w niej, także dla grupy jednoosobowej. Projekt działający w środowisku, którego nie obsługuje żaden agent w grupie, kończy się błędem z komunikatem wskazującym grupę i środowisko, zamiast wracać do agenta wskazanego w kroku. Jest to celowe — alternatywą byłoby ciche uruchamianie prac produkcyjnych na maszynie testowej. Dodaj agenta dla każdego środowiska, w którym działają Twoje projekty, i zostaw grupę pustą u agenta, który ma nadal obsługiwać wszystko.

Wyjęcie agenta z grupy zawęża zakres obsługiwany przez grupę, więc jest równie istotne jak dodanie go. Wyczyszczenie grupy u agenta, który obsługiwał Twoje środowisko domyślne, sprawia, że projekty działające w nim nie mają do czego się odwołać i kończą się błędem przy następnym uruchomieniu. Przed usunięciem członka przenieś środowisko na innego członka grupy. Każdy zapis, który zmienia zakres obsługiwany przez grupę, zgłasza Ci nowy zakres.

Środowiska są współdzielone z połączeniami, więc nazwy środowisk oferowane tutaj są tymi samymi, w których konfigurujesz połączenie. Zobacz Tworzenie połączenia i zarządzanie nim.

Dopasowanie maszyny agenta

Środowisko ustawione tutaj musi odpowiadać środowisku, dla którego skonfigurowano usługę PlaidLink na tej maszynie. PlaidLink subskrybuje jedną dokładną kolejkę dla środowiska wskazanego w jego pliku konfiguracyjnym, więc agent, którego rekord wskazuje QA, a którego maszyna nadal jest skonfigurowana dla środowiska domyślnego, nasłuchuje na innej kolejce niż ta, do której trafia praca. Krok czeka, a następnie kończy się błędem informującym, że agent nie podejmuje zadania.

Ustaw to w bloku environments pliku konfiguracyjnego PlaidLink, we wpisie dla tego agenta:

environments:
  - name: QA
    agent_id: <agent identifier>

name to nazwa środowiska widoczna w PlaidCloud. Jeśli zostanie pominięta, agent obsługuje środowisko domyślne. Po zmianie uruchom ponownie usługę PlaidLink.

Notatka

Pojedyncza usługa PlaidLink może zawierać kilka wpisów w tym bloku, więc jedna maszyna może obsługiwać więcej niż jednego agenta lub tego samego agenta w więcej niż jednym środowisku. Zobacz Uruchamianie wielu agentów.

Uruchamianie wielu agentów

PlaidLink został zaprojektowany tak, aby umożliwiać działanie wielu agentów w ramach jednej instalacji usługi. Taka uproszczona instalacja pozwala jednej instalacji obsługiwać agentów z wielu obszarów roboczych i / lub agentów o różnych poziomach uprawnień do wykonywania zadań.

Aby włączyć wielu agentów, wystarczy dodać poświadczenia agentów do pliku konfiguracyjnego PlaidLink.

Uruchamianie wielu usług PlaidLink

Podobnie jak w przypadku uruchamiania wielu agentów w jednej usłudze PlaidLink, można również uruchomić wiele usług PlaidLink.

Bywa to konieczne w zależności od stosowania zabezpieczeń opartych na systemie lub ograniczeń dostępu sieciowego, które uniemożliwiają komunikację przez granice sieci.

Notatka

Zwykle lepiej jest uruchamiać wielu agentów w ramach jednej usługi niż wiele usług na jednej maszynie. Jednak w zależności od przypadku użycia może być konieczne uruchomienie wielu odrębnych usług.

Wymagania dotyczące mocy obliczeniowej, pamięci i dysku

Usługa PlaidLink jest niezwykle lekka i do działania potrzebuje minimalnej mocy obliczeniowej i pamięci. Przy przetwarzaniu dużych wolumenów danych może być konieczne zwiększenie zasobów obliczeniowych, a zwłaszcza pamięci.

Zwykle agent działa bez problemu przy 5% CPU i 200 MB pamięci. Przy intensywnych operacjach na danych zaleca się przydzielenie całego procesora i co najmniej 4 GB pamięci RAM. W systemach z dynamicznym przydziałem zasobów, takich jak Kubernetes, wystarczy, że agent ma dostęp do zasobów elastycznych (burstable), a nie zarezerwowanych.

Miejsce na dysku dla agenta jest również minimalne. Operacje agenta wykorzystują miejsce na dysku jako bufor danych podczas przesyłania dużych ilości danych. Zazwyczaj 8 GB wystarcza do normalnej pracy. Przy intensywnych operacjach na danych zaleca się zwiększenie miejsca na dysku odpowiednio do oczekiwanych wolumenów danych. Nie ma ustalonej wartości, ponieważ zależy to od kilku czynników, w tym prędkości procesora, prędkości sieci, ilości danych itp. Dobrym punktem wyjścia jest jednak 20 GB, które można dostosować w razie potrzeby.

Wymagania sieciowe

Agent PlaidLink został zaprojektowany tak, aby działać przy minimalnej wymaganej konfiguracji. Nie wymaga specjalnego VPN ani konfiguracji sieci poza dopuszczeniem standardowego ruchu sieciowego HTTPS. Agenci komunikują się tym samym protokołem co zwykły ruch przeglądarek internetowych.

Usługa agenta zawsze inicjuje komunikację z PlaidCloud, więc nie ma potrzeby konfigurowania dostępu przychodzącego w zaporach sieciowych.

Notatka

Czasami reguły zapory blokują cały dostęp, nawet standardowy ruch HTTPS. Jeśli agent zgłasza przy uruchomieniu, że nie może skontaktować się z PlaidCloud, musisz skontaktować się z zespołem sieciowym, aby otworzyć port 443 dla ruchu.