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 instalado 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 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 e aperte a tecla Enter.

Dica!

Para ver a lista de Workspaces disponíveis pelo seu terminal, execute o comando stk list workspace.
O Workspace em uso aparece com 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 às 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 é preenchida automaticamente. Em seguida, você deve 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 alias já vem preenchido com um nome como infra-bucket-s3-1696278774680.

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

O alias é imutável depois de configurado.

Passo 3. Responda às perguntas no seu terminal. Caso algum Plugin exija alguma Connection Interface, informe o alias da utilização 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 os 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-infraestrutura>

Em seguida, execute o comando para registrar:

stk register infra

Responda às perguntas:

• URL do repositório: informe o repositório que irá armazenar o código da sua infraestrutura.
• Base branch: informe a branch que 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.

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 da Infraestrutura: confira a seção de Deploy.
• Gerenciar a execução de Actions na sua Infraestrutura.
• Gerenciar e acompanhar sua Aplicação.
• Para destruir sua Infraestrutura, confira a seção de Destroy.