Como entregar infraestrutura como código no repositório do cliente estrangeiro

Para entregar infraestrutura como código a um cliente estrangeiro, confirme onde ficará o código, quem poderá executá-lo e qual evidência comprova o aceite. Uma entrega de Terraform pode incluir configuração, documentação, pipeline e orientação sobre o estado. O contrato deve indicar quais desses itens fazem parte do serviço e em que momento a invoice poderá ser enviada.

Defina o repositório e a responsabilidade pela execução

Combine em qual organização do cliente o código será armazenado e como a equipe terá acesso. Registre a branch, o ambiente e o procedimento de revisão. Identifique quem aprova a mudança e quem pode executar a aplicação no ambiente do cliente. Se o contratado entrega só o código e um plano revisado, deixe claro quem fará a implantação e quais permissões são necessárias.

A documentação do Terraform recomenda armazenar o estado de forma adequada à colaboração e trata de controles para dados sensíveis. O estado pode conter informações sensíveis. Ele precisa de um destino e de uma política de acesso próprios. Entregar os arquivos de configuração por Git não equivale a transferir o estado, o acesso aos ambientes ou as credenciais.

Estruture o aceite por evidência

Combine quais informações podem ser anexadas à evidência de aceite. Um log, um arquivo de plano ou um trecho do estado pode conter dados que o cliente exige proteger. Use as referências e os relatórios permitidos pela política do projeto. No documento comercial, cite o marco e o identificador da entrega, mantendo os arquivos técnicos no repositório ou na ferramenta autorizada.

Exemplo de projeto em dois marcos

Uma consultoria brasileira é contratada por USD 8.000 para preparar infraestrutura de homologação e produção. O primeiro marco de USD 3.000 exige repositório aprovado, documentação e plano de homologação revisado. O segundo, de USD 5.000, exige entrega do pipeline de produção e uma execução supervisionada com aceite. A empresa registra o commit e o protocolo de revisão que sustentam cada marco.

Se o cliente aprovar a homologação e adiar a execução em produção, a primeira invoice segue conforme o marco aceito. A segunda permanece no controle de entregas com motivo, data e responsável. Se o cliente quiser mudar o segundo aceite para um plano aprovado sem execução, registre o ajuste comercial e técnico antes de considerar o marco concluído. A planilha deve mostrar o que o contrato exigia e o que as partes aprovaram.

Separe transferência de código e transferência de acesso

Ao encerrar o projeto, confira se o cliente consegue localizar o repositório, a documentação e o backend designado. Confirme quem responde pelas credenciais e como a equipe manterá o pipeline. Faça a transição pelo mecanismo acordado, sem anexar chaves ou tokens à invoice ou ao relatório de entrega. Se o acesso de prestador precisa ser removido, registre quem executará a ação e quando.

Se a infraestrutura já existe e o trabalho envolve mover estado, identifique o procedimento técnico aprovado e preserve as evidências da migração. O Terraform documenta regras e cuidados para configuração de backend e armazenamento de estado. Trate a migração como uma etapa própria quando ela altera risco, prazo ou permissões. Use o aceite do ambiente previsto no contrato.

Ligue a invoice ao trabalho realmente aceito

No fechamento, guarde contrato, ordem de compra, entrega e aceite. Identifique a moeda e a data de pagamento. Se houver horas de acompanhamento depois do marco, indique se estão incluídas ou se exigem nova autorização. Caso a invoice inclua dois marcos, mantenha uma linha por entrega com o valor associado. Envie à contabilidade os comprovantes comerciais e financeiros necessários à análise.

Documente as dependências que ficam fora do código

Liste as variáveis que precisam ser fornecidas pelo cliente, as permissões necessárias e a versão das ferramentas usadas. Se o ambiente depende de um módulo privado, confirme quem mantém o acesso e qual versão foi aprovada. Se depende de um serviço provisionado por outra equipe, guarde a referência da solicitação. Um repositório pode estar completo para revisão e ainda depender de uma autorização externa para execução.

Na entrega final, peça que o responsável do cliente faça uma conferência com a documentação disponível. Registre o que conseguiu reproduzir e as pendências que dependem do prestador. Se houver uma janela de suporte pós-entrega, indique a data de início, a duração e o que será tratado dentro dela. A equipe comercial pode vincular o suporte a um marco próprio quando ele tiver preço e aceite separados.

Perguntas frequentes

Posso cobrar assim que abrir o pull request?

Confira o critério de aceite acordado. Se o marco exige aprovação, execução ou documentação, guarde a evidência correspondente antes de considerar a entrega concluída.

O estado do Terraform deve ir no mesmo repositório?

Defina a política com o cliente e siga a documentação do backend. O estado pode conter dados sensíveis e precisa de armazenamento e acesso adequados.

O que guardar sem expor detalhes técnicos?

Use identificadores de commit, registros de aprovação e evidências permitidas pelo cliente. Mantenha credenciais, estado e artefatos sensíveis nos ambientes autorizados.

Fontes oficiais

• HashiCorp — estado do Terraform
• HashiCorp — configuração de backend
• HashiCorp — tratamento de dados sensíveis

Leituras relacionadas

• Como cobrar integração de API de um cliente estrangeiro
• Guias para exportadores de serviços

Como a Zen pode ajudar

A contabilidade para exportação de serviços da Zen ajuda a organizar documentos, conciliar recebimentos e analisar as regras da sua operação. Peça uma proposta personalizada para conversar sobre o seu caso.