Criar Infraestrutura via STK CLI

Visão Geral

Uma Infraestrutura é criada a partir de Stacks que contêm Plugins de Infraestrutura, responsáveis por gerar suas peças de infraestrutura, como código IaC (Infrastructure as Code). Esse processo é semelhante ao de uma Aplicação, que gera apenas o código fonte a partir dos Plugins de Aplicação.

As Infraestruturas podem ser criadas na StackSpot por dois canais:

• STK CLI; e
  -Portal StackSpot EDP.

A seguir, você encontra os passos para criar Infraestruturas pelo STK CLI utilizando Workflows.

Pré-requisitos

• Já ter o STK CLI e ser membro de um Workspace.
• Estar logado em uma conta StackSpot.
• Acessar um Estúdio.
• Você precisa de uma Stack com um Starter e Workflow do tipo 'create'/'starter', criados e prontos para serem utilizados.
• 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).
• Confira com o administrador da conta o gerenciamento do 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) do usuário ou da conta. Você deve configurá-lo em 'Conexões Externas'.

Cuidado!

Se você não atender a algum dos pré-requisitos mencionados, pause este guia e acesse o link correspondente ao requisito pendente para resolvê-lo antes de continuar.

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:

Dica!

Para os nomes de Estúdio, Stack, e Workflow. Use sempre o slug, o slug é o nome que está registrado no Portal da StackSpot EDP. Pode ocorrer do nome utilizado ter alguma diferença do nome registrado no Portal, o que pode causar erros ao criar a Infraestrutura pelo STK CLI.

stk create infra [NOME-INFRAESTRUTURA] --workflow [NOME-ESTUDIO/NOME-STACK/NOME-WORKFLOW]

Exemplo:

stk create infra infra-com-workflow --workflow nome-stack/nome-estudio/nome-workflow-create-infra

Atenção!

• Se o argumento --workflow for fornecido, a CLI executará o Workflow especificado do tipo create ou starter.
• O Workflow será responsável por todas as etapas, incluindo aplicação de Plugins, configuração de inputs e qualquer lógica adicional definida no Workflow.
• Caso ambos os argumentos --starter e --workflow sejam fornecidos, a CLI retornará um erro, pois eles são mutuamente exclusivos.

Responda às perguntas do Workflow no terminal e sua Infraestrutura será criada.

Dica!

Se você quiser nomear a Aplicação com um nome diferente da pasta (diretório), use o parâmetro --target ou -o.

Confira um exemplo de como o comando deveria ficar a seguir:

stk create infra infra-com-workflow --workflow nome-stack/nome-estudio/nome-workflow-create-infra --target home/user/Infrastructures/my-infra

Passo 3. 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.