Planeje uma unidade de infraestrutura
Direcione um modelo a uma unidade de rede, banco ou aplicação. Deixe o escopo visível antes de iniciar o plano.
Compartilhe um trabalho preparadoExecute unidades Terragrunt sem reconstruir o contexto
Mantenha a estrutura Terragrunt no Git. Salve diretório, workspace e entradas no Semaphore e dê à equipe uma forma clara de planejar e executar cada operação.
Qual unidade de infraestrutura este comando afetará?
Em um repositório Terragrunt, diretório inicial e argumentos definem o escopo. Um comando memorizado não basta para transferir a operação a outra pessoa.
Inclua a unidade e suas entradas no trabalho
- Salve o diretório que contém terragrunt.hcl
- Escolha o workspace e o runtime Terraform ou OpenTofu
- Revise as unidades afetadas na saída da tarefa
Facilite a repetição de operações Terragrunt
Reutilize o mesmo repositório entre ambientes
Crie modelos nomeados para os diretórios de ambiente e grupos de variáveis relevantes. Mantenha a configuração compartilhada no Git.
Compartilhe um trabalho preparado
Coordene uma mudança de infraestrutura mais ampla
Configure os argumentos de múltiplas unidades compatíveis com sua versão Terragrunt. O Terragrunt avalia as dependências dos módulos e o Semaphore registra a saída da tarefa.
Conecte trabalhos em um workflowEscolha uma unidade Terragrunt e inspecione seu plano
O modelo define o diretório com terragrunt.hcl, deixando a unidade em escopo visível antes de executar.
Terragrunt avalia essa unidade usando Terraform ou OpenTofu por baixo. Um plano propõe alterações sem aplicá-las.
Leve uma implantação Terragrunt até a prontidão do serviço
Mantenha dependências de módulos no Terragrunt. Use um workflow para passar saídas à configuração Ansible e seguir com verificações Python do serviço. Adicione um ramo de diagnóstico quando uma tarefa falhar.
Execute unidades de infraestrutura
Em caso de sucesso→Saídas → entradas
Configure os sistemas
Em caso de sucesso→Saídas → entradas
Verifique o serviço
Em caso de falha
Colete diagnóstico
Colete diagnósticoDiretório, ferramentas e estado por trás de cada execução
Salve o diretório de entrada
Selecione o subdiretório do repositório com terragrunt.hcl. Use modelos nomeados separados quando unidades ou ambientes precisarem de pontos de entrada distintos.
Prepare Terragrunt e o binário subjacente
Habilite Terragrunt Code em Aplicações. Instale terragrunt e o binário Terraform ou OpenTofu no servidor ou runner e teste a combinação de versões usada pelo repositório.
Reutilize variáveis e configurações de workspace
Grupos fornecem entradas de ambiente, incluindo TF_VAR_. Selecione inventário de workspace Terragrunt e use o backend configurado da operação.
Mantenha dependências de módulos no Terragrunt
Terragrunt avalia dependências da própria configuração. Workflows Semaphore coordenam modelos separados. Configure argumentos CLI de múltiplas unidades para a versão Terragrunt instalada.
Documentação e recursos relacionados
FAQ
Por que Terragrunt não aparece nas aplicações?
Habilite Terragrunt Code em Aplicações antes de criar o modelo. A aplicação é desabilitada por padrão. Instale também terragrunt e o binário Terraform ou OpenTofu que ele usará no servidor ou runner que executa a tarefa.
Qual diretório do repositório usar em um modelo Terragrunt?
Selecione o subdiretório com terragrunt.hcl para a operação pretendida. Diretório e argumentos de comando determinam o escopo. Use modelos nomeados para unidades ou ambientes distintos, permitindo à equipe reconhecer os alvos antes de iniciar.
O Terragrunt pode usar OpenTofu em vez de Terraform como ferramenta subjacente?
Sim. A integração Semaphore suporta Terraform ou OpenTofu como binário subjacente. Prepare Terragrunt e o binário escolhido no ambiente. Teste versões com a configuração e forneça acesso a módulos, provedores e backend.
Posso executar várias unidades Terragrunt a partir de um modelo?
Você pode configurar múltiplas unidades pelos argumentos CLI do modelo. Use a sintaxe da versão Terragrunt instalada. Diretório e argumentos determinam as unidades afetadas; Terragrunt avalia suas dependências.
Posso agendar um plan Terragrunt para uma unidade específica?
Sim. Salve diretório e workspace da unidade em modelo Terragrunt, configure somente Plan e agende. Cada tarefa agendada mantém sua saída. Confira o escopo do comando antes de usar recorrência em múltiplas unidades.
Como as dependências Terragrunt diferem dos workflows Semaphore?
Terragrunt avalia dependências entre módulos de infraestrutura. Um workflow Semaphore coordena modelos de tarefa que podem usar ferramentas diferentes. Por exemplo, uma implantação Terragrunt pode ser seguida de configuração Ansible e verificações Python sem substituir o grafo interno de dependências dos módulos.
Outras equipes podem executar uma operação Terragrunt salva?
Sim. Dê aos colegas acesso ao projeto para executar o modelo preparado. Salve diretório de entrada, workspace e entradas claros para reconhecer o escopo. Enterprise pode restringir a modelos selecionados quando acesso amplo não for necessário.
Como passar variáveis a um trabalho Terragrunt?
Anexe grupos de variáveis para entradas de ambiente, incluindo valores TF_VAR_ usados pela configuração subjacente. Variáveis extras e variáveis de formulário são passadas como entradas de execução compatíveis. Guarde credenciais de provedores e backend em entradas secretas, em vez de enviá-las ao repositório.