Export do Terraformu

Export do Terraformu

Sencai umí vygenerovat Terraform konfiguraci (HCL) pro cloudové instance, které spravuje — zrcadlovou operaci k importu existující infrastruktury. Zatímco import přivádí vaše existující zdroje do Sencai, export vám umožní vzít zdroje sledované v Sencai zpátky ven jako obyčejný, čitelný .tf text, který si můžete prohlédnout, upravit a sami aplikovat.

---

Co export dělá — a co ne

• Export generuje pouze text. Nikdy nespouští terraform apply, jako součást samotného exportu nikdy nekontaktuje vašeho cloud providera vaším jménem a nikdy neupravuje žádný živý zdroj.
• Vygenerovaný soubor nikdy neobsahuje přihlašovací údaje ani secrety — žádné access keys, API tokeny ani hesla. Vlastní autentizaci providera doplníte sami, než Terraform spustíte.
• Každý exportovaný soubor začíná hlavičkovým komentářem s časem vygenerování a připomínkou zkontrolovat před apply — berte ho jako výchozí bod, ne jako drop-in náhradu infrastruktury, kterou už spravujete jinde.

Podporovaní provideři a zdroje

	Podporováno
Provideři	AWS, GCP, Azure, Hetzner
Zdroje	Cloudové instance (vždy); cloudové sítě (volitelně, pokud zahrnete)

Pokud vybraná instance používá providera mimo tento seznam (například DigitalOcean), je přeskočena, ne tiše zahozena — export se pro podporované instance stejně dokončí a přeskočené jsou vypsané s důvodem, takže přesně víte, co ve výstupu chybí.

Poznámka

Protože se samotné typy Terraform zdrojů vyvíjejí, instance, kterou jste původně importovali z existujícího stavu azurerm_virtual_machine, se při exportu vrátí jako aktuální, nezastaralý typ zdroje azurerm_linux_virtual_machine — hodnoty se přenesou, ale nejde o bajt-za-bajt round-trip na úrovni samotného typu zdroje.

Krok za krokem: export instancí

Krok 1: Vyberte instance

1. Přejděte do Cloud Instances
2. Pomocí checkboxů vyberte jednu nebo více instancí, které chcete exportovat
3. Klikněte na Export as Terraform (aktivní jen když je vybraná alespoň jedna instance)

Krok 2: Nastavte export

V otevřeném dialogu:

• Přepněte include network, pokud chcete do výstupu zahrnout i asociované cloudové sítě
• Volitelně zúžte výběr podle providera, pokud vaše selekce zahrnuje víc než jednoho

Krok 3: Počkejte na dokončení jobu

Export běží jako background job, stejně jako import — během zpracování uvidíte živý stav (submitting → running → completed/failed). U pár instancí to obvykle trvá jen několik sekund.

Krok 4: Prohlédněte, zkopírujte nebo stáhněte

Po dokončení jobu uvidíte:

• Náhled vygenerovaného .tf textu
• Copy — zkopíruje celý text do schránky
• Download — uloží ho jako .tf soubor (pojmenovaný sencai-export-<timestamp>.tf)
• Seznam případných přeskočených instancí a proč (např. „provider not supported for export”), pokud relevantní

Co dělat s exportovaným souborem

Exportovaný .tf soubor je výchozí bod pro převedení těchto zdrojů do vlastního Terraform workflow:

1. Přidejte blok provider s vlastními přihlašovacími údaji (nikdy nejsou součástí exportu)
2. Přidejte state backend dle vlastní volby
3. Spusťte terraform init a terraform plan, abyste zkontrolovali, co by Terraform udělal — protože zdroje už existují, možná je budete muset před aplikací naimportovat (terraform import) do svého state, nebo upravit vygenerované bloky tak, aby odpovídaly vaší existující struktuře modulů
4. Před terraform apply vše pečlivě zkontrolujte — soubor je generován ze záznamů Sencai o daném zdroji, ne živým čtením od providera, takže ověřte cokoliv, co jste u zdroje nedávno změnili mimo Sencai

Export vs. import

	Import	Export
Směr	Existující cloudové zdroje → Sencai	Zdroje sledované v Sencai → Terraform text
Vstup	Přihlašovací údaje k vašemu cloud účtu	Vybrané cloudové instance
Výstup	Zdroje adoptované do správy Sencai	Stažitelný .tf soubor
Upravuje něco?	Ne — jen čtení (scan)	Ne — jen generování textu

---

Nejčastější problémy

Otázka: Export doběhl, ale některé instance ve výstupu chybí.

Odpověď: Zkontrolujte seznam přeskočených instancí zobrazený po dokončení jobu — instance s nepodporovaným providerem (dnes cokoliv jiného než AWS, GCP, Azure nebo Hetzner) je přeskočena s uvedeným důvodem, ne tiše vynechána.

Otázka: Export job selhal úplně.

Odpověď: Obvykle jde o dočasný problém na backendu, ne o něco specifického u vašich instancí. Zkuste export znovu; pokud selhává opakovaně, kontaktujte podporu.

Otázka: Můžu exportovat sítě bez instancí?

Odpověď: Sítě se exportují spolu s vybranými instancemi (přes volbu „include network”) — export dnes funguje z výběru instancí, ne ze samostatného výběru sítí.

Otázka: Ovlivňuje export nějak živý zdroj?

Odpověď: Ne. Export jen čte vlastní záznamy Sencai a generuje text — nikdy nekontaktuje vašeho cloud providera ani zdroj nemění.