Pular para o conteúdo principal

Deploy de uma Infraestrutura

Nesta seção, você encontra como fazer o deploy da sua Infraestrutura.


Cuidado!

O fluxo de configuração de Deploy e adição de contas Cloud na StackSpot desta forma só está disponível para:

  • Contas Enterprise criadas antes de 2024.

Contas Enterprise criadas a partir de Janeiro de 2024 devem fazer Deploy via Runtimes Self-hosted.

Atenção!

Esse fluxo de deploy é exclusivo para contas StackSpot Enterprise pois utilizam os serviços de Deploy e Self-Hosted da StackSpot.


Você pode fazer o deploy de uma Infraestrutura no STK CLI.

Fazer o deploy no STK CLI

Pré-requisitos

Siga os passos:

Passo 1. No seu terminal, selecione o seu Workspace com o comando:

stk use workspace <nome-workspace>

Passo 2. Faça o deploy da sua Infraestrutura, execute o comando no seu terminal:

stk deploy infra --env<environment-id> --version<version> -w

Exemplo:

stk deploy infra -e prod -v v1 --watch
Dica!
  • Version: É a tag da Infraestrutura que aparece no Portal, caso o deploy for realizado com sucesso.
  • Environment: É o ambiente configurado no Workspace onde a Infraestrutura será implantada. O ambiente precisa ter uma conta de Nuvem já configurada e associada a ele.
  • Branch: É o nome da sua branch utilizada junto com o repositório informado no manifesto da Aplicação, e esta é uma flag opcional. Se você precisa fazer o checkout do repositório durante o processo de deploy, ao informar essa flag, o repositório será clonado na branch especificada. Confira o passo a passo para liberar liberar o acesso a repositórios privados.

Passo 3. Acompanhe o deploy executando o comando:

stk deploy status <id>

Neste caso, o id é um argumento que aparece logo após de você ter feito o deployment.

Os status retornados são:

  • Running: em execução.
  • Succeeded: deploy bem-sucedido.
  • User error: erro de usuário. Geralmente está relacionado a algum um erro na execução do comando terraform apply ou porque o template de IaC do Plugin não foi gerado conforme esperado. Além disso, também pode ser por causa de um problema de permissão na conta de Cloud.
  • Runtime error: erro no Deploy. É um interno na StackSpot que ainda não está tratado e precisa de maior avaliação do time de engenharia.
  • Aborted: quando uma task da run falha, as demais que estão pendentes são abortadas.
Informação Adicional

Para debugar o deploy e ter acesso aos logs do Terraform, execute o comando:

stk deploy status 01H8FCXE6ZEM79X9HJYSVN12C0 --report md

O que você pode fazer depois do deploy?

Confira o que você pode fazer depois de ter feito o deploy da sua Infraestrutura:

1. Monitorar uma Infraestrutura no Portal da StackSpot

Pré-requisitos

  • Já ter registrado uma Infraestrutura.
  • Ter feito o deploy de uma Infraestrutura.

Siga os passos:

Passo 1. No Dashboard do seu Workspace, selecione a ‘Infraestrutura’ que você quer monitorar;

Passo 2. Clique na aba 'Atividades' e acompanhe a sua Infraestrutura.

Nesta tela, você pode acompanhar o histórico de deploys realizados com suas versões respectivas, assim como os Desvios detectados pelo Deploy.

2. Rollback de uma Infraestrutura

O Rollback funciona como um Deploy, mas com um ID específico. Baseado em um Deploy específico, ao executar um Rollback, uma versão é indicada para que haja um novo Deploy com os mesmos IaCs gerados na versão.

O usuário que fará o Rollback deve ter a seguinte role: runtime:deploy_infra.

Siga os passos:

Passo 1. No seu terminal, entre na pasta do seu projeto e depois selecione o seu Workspace com o comando:

stk use workspace <nome-workspace>

Passo 2. Execute o comando:

stk rollback infra --version<version> --env<environment-id>
  • version: é a versão já deployada escolhida para fazer o rollback. No rollback, um novo deploy é feito baseado na versão informada, sem precisar criar uma nova tag.

Para acompanhar o status do rollback, execute o seguinte comando:

stk rollback status

Para mais informações sobre o comando de destroy, confira a seção de Comandos.

3. Destruir (destroy) de uma Infraestrutura

Atenção

Este recurso está temporariamente desativado. Durante esse período, se precisar destruir uma Infraestrutura, contate o nosso suporte.

Representa a "destruição" de uma Infraestrutura. Se você não conseguir apagar uma Infraestrutura, você deve destruí-la primeiro.

O usuário que fará o destroy deve ter a seguinte role: runtime:destroy_infra.

Para fazer isso, execute o comando no seu terminal:

stk destroy infra --env<environment-slug> --watch

Exemplo:

stk destroy infra -e sandbox -w
  • Para acompanhar o status do destroy, execute o comando:
stk destroy infra --env<environment-slug> --watch
  • Uma outra forma de ver o status é usar o identificador (id) que aparece no seu terminal logo após executar o comando de destroy. Execute no seu terminal:
stk destroy infra status -id

Exemplo:

stk destroy infra status 01H8FCXE6ZEM79X9HJYSVN12C0

Para mais informações sobre o comando de destroy, confira a seção de Comandos.