Criar Infraestrutura via STK CLI

Nesta seção, você encontra um guia de como criar a sua Infraestrutura no STK CLI.

Uma Infraestrutura é gerada por Stacks que possuem Plugins de Infraestrutura que geram as suas peças de infraestrutura (código IAC). Semelhante a uma Aplicação que gera apenas o código fonte a partir dos Plugins de Aplicação.

Confira os passos

Pré-requisitos

• Já ter o STK CLI e ser membro de um Workspace.
• Estar logado em uma conta StackSpot.
• Acessar um Estúdio.
• Ter uma Stack e um Starter.
• Já ter ambientes criados.
• Já ter configurado o Deployment via Self-Hosted para configurar e conectar os ambientes na Conta Cloud
• Já ter SCM configurado (Quem faz essa configuração é a pessoa responsável por administrar sua conta).
• Caso a sua conta seja Enterprise e o administrador decida que que os usuários devem gerenciar o acesso ao
  SCM

  Source code management (SCM) rastreia alterações em um repositório de código, mantendo um registro de modificações e auxiliando na gestão de conflitos que surgem ao integrar atualizações de diferentes colaboradores.
  via PAT (Personal Access Token) de forma individual, você deve configurá-lo em 'Conexões Externas'.

Se você não cumprir algum dos requisitos acima, pare de seguir esse guia e acesse o link do requisito que falta.

Siga os passos para criar sua Infraestrutura no STK CLI

Passo 1. No seu terminal, selecione o Workspace que você quer utilizar para criar a Infraestrutura. Execute o comando:

stk use workspace

Em seguida os Workspaces da sua conta serão listados no terminal. Selecione o Workspace aperte a tecla Enter.

Dica!

Para ver a lista de Workspaces disponíveis pelo seu terminal, execute o comando stk list workspace . O Workspace que você está tem um asterisco.

Você também pode conferir no Portal da StackSpot na seção de 'Workspaces'.

Passo 2. Para criar uma Infraestrutura, execute o comando:

stk create infra

Responda as perguntas no terminal:

• Nomeie sua Infraestrutura: Insira o nome da sua Infraestrutura;

• O limite do nome da Infraestrutura é de 60 caracteres.

• Você deseja iniciar um repositório git?: Responda '(Y/n) Sim ou Não' para iniciar um repositório Git na pasta da Infraestrutura. Se a resposta for '(Y) Sim', em seguida você deve informar a URL do repositório remoto;

• Descrição da Infraestrutura: Insira uma breve descrição para a sua Infraestrutura;

• Selecione o studio: Selecione um dos Estúdios disponíveis em sua conta;

• Selecione a stack: Selecione a Stack desejada;

• Selecione a versão da stack: Selecione a versão da Stack que você quer utilizar.

• Selecione os plugins de infra desejados: Selecione na lista exibida no terminal, os Plugins do tipo Infraestrutura desejados;

• Nomeie a utilização do plugin: A utilização dos Plugins são preenchidas automaticamente, você deve em seguida responder os inputs dos Plugins.

Atenção!

Você pode aplicar um mesmo Plugin mais de uma vez na sua Infraestrutura. Por isso, a pergunta aparece todas as vezes.

? Nomeie a utilização do plugin (studio/stack/nome-do-plugin)

Este é o alias de utilização do Plugin e já vem preenchido automaticamente pelo STK CLI. Por exemplo:

• O nome do Plugin é infra-bucket-s3
• Se for a primeira vez que você aplica este plugin, o o alias já vem preenchido com o nome infra-bucket-s3-1696278774680, por exemplo.

O alias serve para indicar qual é o objetivo desta primeira aplicação do Plugin e evitar nomes duplicados.

O alias é imutável depois de configurado.

Passo 3. Responda as perguntas no seu terminal. Caso algum Plugin exija alguma Connection Interface, informe o alias do uso de cada uma.

Repita o processo para todos os Plugins que você aplicar.

Sua Infraestrutura foi criada.

Atenção!

O arquivo stk.yaml de uma Aplicação ou Infraestrutura não deve ser editado manualmente. Você pode modificar os Plugins da sua Aplicação ou Infraestrutura, para isso, use comandos a seguir:

• Para modificar a versão ou configurações de um Plugin:

stk update plugin

• Para remover um Plugin:

stk remove plugin

• Para adicionar novos recursos ao seu projeto:

stk apply plugin

Passo 4. Registre a sua Infraestrutura na sua Conta. Para isso, primeiro acesse o diretório dela:

cd <nome-da-infra-compartilhada>  

Em seguida execute o comando para registrar:

stk register infra

Responda as perguntas:

• URL do repositório: Informe o repositório que irá armazenar o código da sua infraestrutura;
• Base branch: Informe a branch para ser utilizada no repositório.

Pronto, você criou e registrou a sua Infraestrutura.

Agora você pode conferir os dados da sua Infraestrutura dentro do seu Workspace no portal da StackSpot na seção 'Infraestruturas'.

Como usar as Variáveis da Conta para configurar Plugins na sua Infraestrutura

Você pode escolher utilizar Variáveis da Conta criadas pela sua Organização para preencher os inputs de Plugins e Actions ao criar sua Infraestrutura.

Para isso, escreva {{ ao responder o input e selecione a Variável que você deseja utilizar.

Para mais detalhes, acesse a página Como Criar Variáveis da Conta para saber mais.

Atenção!

O deploy da Infraestrutura só é feito neste momento caso sua organização tenha configurado o deploy via Runtime Self-Hosted.

Próximos passos

• Fazer o Deploy Infraestrutura, confira a seção de Deploy.
• Gerenciar a execução de Actions na sua Infraestrutura.
• Gerencie e acompanhe sua Aplicação.
• Para destruir sua Infraestrutura, confira a seção de Destroy.