--- title: "Skonfiguruj Tulip za pomocą Ansible" slug: "configure-ansible-with-tulip" updated: 2026-10-22T14:46:15Z published: 2026-10-22T14:46:15Z canonical: "support.tulip.co/configure-ansible-with-tulip" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Skonfiguruj Tulip za pomocą Ansible Ansible to otwarte narzędzie IT z wierszem poleceń służące do zbiorczego zarządzania urządzeniami brzegowymi. Dowiedz się więcej o Ansible [tutaj](https://docs.ansible.com/projects/ansible/latest/getting_started/introduction.html). ## Dla kogo przeznaczony jest ten przewodnik - Użytkownicy posiadający pełne uprawnienia do urządzeń brzegowych Permission - Użytkownicy zaznajomieni z Ansible - Użytkownicy zaznajomieni z konfiguracją urządzeń brzegowych ## Jak to działa Ansible to oprogramowanie do zarządzania infrastrukturą IT, które umożliwia kopiowanie i wklejanie konfiguracji urządzeń. Odbywa się to poprzez wykorzystanie **urządzenia wzorcowego (golden device)** jako zweryfikowanej, bazowej konfiguracji, która posłuży do skonfigurowania urządzenia docelowego. Na przykład można skonfigurować kilka nowych urządzeń brzegowych (urządzeń docelowych) jednocześnie, przypisując je do grupy, która automatycznie stosuje dane uwierzytelniające z istniejącego urządzenia referencyjnego (urządzenia wzorcowego). Urządzenie wzorcowe można aktualizować o kolejne ulepszenia i rozpowszechniać te aktualizacje. ![Edge device bulk configuration workflow](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Edge%20device%20bulk%20configuration%20workflow.png) Metoda ta zapewnia zautomatyzowane i skalowalne zarządzanie infrastrukturą IT oraz ogranicza potencjalne błędy wynikające z ręcznej konfiguracji. ## Integracja urządzeń brzegowych z Ansible Poniższe procedury opisują, jak zintegrować funkcje kolekcji Tulip Edge z istniejącymi przepływami pracy w Ansible. ### Zainstaluj kolekcję Tulip Edge 1. W terminalu uruchom następujące polecenie:`ansible-galaxy collection install git+https://github.com/tulip/tulip-ansible-library.git#/collections/ansible_collections/tulip/edge` 2. Aby zainstalować repozytorium dla urządzeń brzegowych, uruchom następujące polecenie:`ansible-galaxy collection install tulip.edge` ### Konfiguracja spisu urządzeń Dodaj poniższy kod do istniejącego spisu urządzeń i uzupełnij zmienne. 1. W poniższym kodzie nadaj nazwę grupie urządzeń i uwierzytelnij swoją instancję, podając adres URL instancji, swój adres e-mail oraz hasło do konta e-mail. `[your_device_group:vars]tulip_factory_url=https://your-factory.tulip.cotulip_admin_email=admin@yourcompany.comtulip_admin_password_sha256=your_sha256_hash` 1. W poniższym kodzie podaj nazwę swojej firmy. `tulip_client_name=NazwaTwojejFirmytulip_client_version=1.0.0tulip_client_description=Brama produkcyjna` ### Wygeneruj skrót hasła Skrót hasła to środek bezpieczeństwa, który przekształca hasło w ciąg znaków o stałej długości, który nie może być łatwo odtworzony ani rozszyfrowany. Ten krok pozwala uniknąć zagrożeń bezpieczeństwa związanych z przechowywaniem haseł w postaci zwykłego tekstu w pliku. Aby wygenerować bezpieczne skróty haseł, wpisz następujące polecenie: `echo -n „twoje_hasło” | sha256sum | cut -d' ' -f1` ### Integracja z podstawowymi playbookami Dodaj niezbędne playbooki do istniejących przepływów pracy za pomocą następującego kodu: ``` * import\_playbook: tulip.edge.register when: register\_devices | default(false) ``` ### Testowanie integracji Dodaj skrypt testowy do swoich przepływów pracy za pomocą poniższego kodu: ```- name: Test uwierzytelniania bramy Tulip hosts: test\_devices tasks: - name: Uwierzytelnij urządzenie testowe import\_playbook: collections/ansible\_collections/tulip/edge/playbooks/gateway\_tulip\_auth.yml ``` - nazwa: Sprawdź, czy uwierzytelnianie zadziałało import_playbook: collections/ansible_collections/tulip/edge/playbooks/gateway_device_info.yml- nazwa: Sprawdź łączność import_playbook: collections/ansible_collections/tulip/edge/playbooks/gateway_check_internet.yml ``` ``` ### Najlepsze praktyki dotyczące integracji 1. **Zarządzanie zmiennymi** - Używaj group_vars do ustawień ogólnych - Używaj host_vars do nadpisywania ustawień specyficznych dla urządzenia - Przechowuj dane wrażliwe w Ansible Vault 2. **Obsługa błędów** ``` * name: Obsługa niepowodzenia uwierzytelniania debug: msg: "Uwierzytelnianie nie powiodło się, sprawdź dane uwierzytelniające" when: auth\_result.failed | default(false) ``` * **Zarządzanie kopiami zapasowymi** * Stosuj spójną nomenklaturę kopii zapasowych, np.: `urządzenie-komponent-znacznik czasu` * Przechowuj nazwy kopii zapasowych w zmiennych w celu ponownego wykorzystania * Wdrażaj zasady przechowywania kopii zapasowych * **Zachowaj idempotencję**. Wszystkie playbooki są idempotentne, a zatem można je bezpiecznie uruchamiać wielokrotnie. Aby znaleźć błędy, zrozumieć przebieg logiki lub zweryfikować skrypt przed uruchomieniem, można przeprowadzić uruchomienie testowe, które nie uruchamia rzeczywistego oprogramowania. Aby przeprowadzić uruchomienie testowe, należy użyć trybu --check, jak pokazano w poniższym przykładzie. `ansible-playbook gateway_tulip_auth.yml --limit test_device --check` ## Konfiguracja urządzenia wzorcowego Proces wdrażania urządzenia wzorcowego pozwala na: 1. **Wybór urządzenia wzorcowego**: Wybierz prawidłowo skonfigurowane urządzenie referencyjne 2. **Utworzenie kopii zapasowej konfiguracji wzorcowej**: Zarejestruj wszystkie konfiguracje komponentów 3. **Wdrożenie na nowych urządzeniach**: Zastosuj ustawienia urządzenia wzorcowego do nowych lub zastępczych urządzeń 4. **Uwierzytelnianie i weryfikacja**: Zarejestruj urządzenia i zweryfikuj wdrożenie ### Konfiguracja spisu urządzeń Skonfiguruj swój inwentarz, uwzględniając urządzenie wzorcowe i urządzenia docelowe. Wpisz w terminalu następujące polecenie: ```[tulip\_edge\_devices]golden-device ansible\_host=172.16.15.130EIO-01-BCDEFA ansible\_host=172.16.15.140EIO-01-CDEFAB ansible\_host=172.16.15.141EIO-01-DEFABCansible\_host=172.16.15.150 [golden\_devices]EIO-01-ABCDEF [newly\_provisioned]EIO-01-BCDEFAEIO-01-CDEFABEIO-01-DEFABC [tulip\_edge\_devices:vars] # Uwierzytelnianie fabryczne tulip\_factory\_url=https://your-factory.tulip.cotulip\_admin\_email=admin@yourcompany.comtulip\_admin\_password\_sha256=your\_sha256\_hash # Informacje o kliencie tulip\_client\_name=Nazwa\_Twojej\_Firmy tulip\_client\_version=1.0.0 tulip\_client\_description=Brama produkcyjna``` ### Generowanie skrótu hasła Skrót hasła to środek bezpieczeństwa, który przekształca hasło w ciąg znaków o stałej długości, który nie może być łatwo odtworzony ani rozszyfrowany. Ten krok pozwala uniknąć zagrożeń bezpieczeństwa związanych z przechowywaniem haseł w postaci zwykłego tekstu w pliku. Aby utworzyć [skrót SHA256](https://www.movable-type.co.uk/scripts/sha256.html) w celu bezpiecznego przechowywania hasła, wprowadź następujące polecenie: `echo -n "twoje_hasło" | sha256sum | cut -d' ' -f1` ### Podstawowa konfiguracja urządzenia typu „golden” Wprowadź poniższy kod dla każdego kroku. 1. Zaloguj się do`urządzenia` wzorcowego:`ansible-playbook tulip.edge.login --limit golden-device` 2. Utwórz kopię zapasową`konfiguracji` urządzenia wzorcowego:`ansible-playbook tulip.edge.backup_mqtt_broker --limit golden-device ansible-playbook tulip.edge.backup_mqtt_bridge --limit golden-deviceansible-playbook tulip.edge.backup_drivers --limit golden-deviceansible-playbook tulip.edge.backup_root_certs --limit golden-device` 3. Zaloguj się do`urządzenia` docelowegoansible-playbook`tulip.edge.login --limit newly_provisioned` 4. Wdróż konfiguracje wzorcowe na urządzenia docelowe```ansible-playbook tulip.edge.restore\_mqtt\_broker \ --limit newly\_provisioned \ -e mqtt\_broker\_backup\_name="golden-device-mqtt-broker-20241219-143022" ansible-playbook tulip.edge.restore\_mqtt\_bridge \ --limit newly\_provisioned \ -e mqtt\_bridge\_backup\_name="golden-device-mqtt-bridge-20241219-143025" ansible-playbook tulip.edge.restore\_drivers \ --limit newly\_provisioned \ -e drivers\_backup\_name="golden-device-drivers-20241219-143028" ansible-playbook tulip.edge.restore\_root\_certs \ --limit newly\_provisioned \ -e root\_certs\_backup\_name="golden-device-root-certs-20241219-143030"``` 1. Uwierzytelnianie za pomocą`factoryansible-playbook tulip.edge.gateway_tulip_auth --limit newly_provisioned` 2. Zarejestruj się w systemach zewnętrznych (opcjonalnie)`ansible-playbook tulip.edge.register --limit newly_provisioned` 3. Sprawdź`` wdrożenie: `ansible-playbook tulip.edge.gateway_device_info --limit newly_provisioned` `ansible-playbook tulip.edge.gateway_check_internet --limit newly_provisioned ``` ### Najlepsze praktyki dotyczące urządzeń wzorcowych Poniższe podejście oparte na urządzeniu wzorcowym zapewnia spójne i niezawodne wdrażanie floty urządzeń Tulip Edge przy zachowaniu pełnej identyfikowalności i kontroli nad standardami konfiguracyjnymi. 1. **Utrzymanie urządzenia wzorcowego**: Dbaj o aktualność i prawidłowe utrzymanie urządzenia wzorcowego 2. **Twórz regularne kopie zapasowe**: Twórz regularne kopie zapasowe konfiguracji urządzenia wzorcowego 3. **Zapewnij kontrolę wersji**: przechowuj kopie zapasowe wzorcowego urządzenia w systemie kontroli wersji, nadając im sensowne nazwy 4. **Stwórz proces testowania**: Zawsze testuj konfiguracje wzorcowego urządzenia w środowisku testowym przed wdrożeniem do produkcji 5. **Dokumentuj konfigurację urządzenia wzorcowego**: Dokumentuj standardy i procedury dotyczące konfiguracji urządzenia wzorcowego 6. **Zapewnij kontrolę dostępu**: Ogranicz dostęp do urządzeń wzorcowych i używaj oddzielnych danych uwierzytelniających 7. **Monitoruj stan i procesy**: Monitoruj stan urządzeń wzorcowych oraz procesy tworzenia kopii zapasowych ### Rozwiązywanie problemów Oto jak rozwiązywać typowe problemy związane z urządzeniami wzorcowymi: #### Nie można nawiązać połączenia z urządzeniem wzorcowym Najpierw sprawdź połączenie z urządzeniem wzorcowym. Uruchom:`ansible golden-device -m ping` Sprawdź stan urządzenia wzorcowego. Uruchom:`ansible-playbook tulip.edge.gateway_device_info --limit golden-device` #### Wdrożenie kopii zapasowej kończy się niepowodzeniem Najpierw należy sprawdzić, czy plik kopii zapasowej istnieje. Uruchom:`ls backups/golden-device-mqtt-broker-*.json` Użyj nazewnictwa kopii zapasowych z`` rozszerzeniem: `ansible-playbook tulip.edge.restore_mqtt_broker \ --limit target-device \ -e mqtt_broker_backup_name="golden-device-mqtt-broker-20241219-143022" \ -vv `` #### Problemy z uwierzytelnianiem Aby ponownie uwierzytelnić urządzenie wzorcowe, uruchom:`ansible-playbook tulip.edge.login --limit golden-device` Aby zweryfikować poświadczenia urządzenia wzorcowego w spisie zasobów, uruchom:`ansible-inventory --host golden-device` {{snippet.Czy znalazłeś to, czego szukałeś?}} ``` **Permissions** Settings for controlling which users have access to specific applications. Use permissions to ensure that only approved users are able to access published applications in production settings.