Criar Infraestrutura via Portal
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 via Portal utilizando Workflows.
Pré-requisitos
- Estar logado em uma conta StackSpot.
- Acessar um Estúdio.
- Ter uma Stack e um Workflow publicados no Estúdio.
- 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 via PAT (Personal Access Token) de forma individual, você deve configurá-lo em 'Conexões Externas'.SCM
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.
Criar Infraestrutura pelo Portal da StackSpot
Siga os passos:
Passo 1. Faça login no Portal StackSpot EDP;
Passo 2. Clique no botão 'Criar' e selecione a opção 'Infraestrutura';
-
Se a pessoa administradora da sua Conta não configurou o SCM, você não poderá continuar. Para mais informações, confira a seção Configurar SCM.
-
Se a pessoa administradora da sua Conta definiu que as pessoas usuárias devem gerenciar o acesso ao SCM via PAT (Personal Access Token) de forma individual, você deve configurá-lo em 'Conexões Externas'.
Passo 3. Selecione o Workspace onde você quer criar a Infraestrutura;
Passo 4. Agora, siga as instruções:
- Selecione uma Stack para criar a Aplicação;
- Selecione a versão da Stack; e
- Em Selecione um Starter: você pode escolher os Starters ou Workflows. Para utilizar um Workflow, escolha as opções que começam com o termo Creating Infra with. Como na imagem a seguir:
Passo 5. Na tela 'Detalhes da Infraestrutura', informe os dados da sua Infraestrutura:
- Nome: o limite do nome da Infraestrutura é de 60 caracteres;
- Descrição: descreva sobre o que é sua Infraestrutura; Clique no botão ’Próximo';
Passo 6. Na tela ’Configurações' preencha todos os inputs do formulário. Os inputs podem mudar de acordo com o Workflow. Depois, clique no botão ’Próximo';
-
Durante o processo de criação de uma Infraestrutura utilizando um Workflow, você não pode adicionar novos Plugins à Infraestrutura. Mas após a criação, você pode adicionar e aplicar novos Plugins à sua Infraestrutura.
-
Se tiver dúvidas ao preencher os inputs, consulte a documentação associada à Stack, Starter ou Workflow que você utilizou para criar a Infraestrutura.
-
Caso existam contextos já configurados, algumas ou todas as variáveis podem já estar preenchidas automaticamente. Para variáveis marcadas como obrigatórias, não será possível editá-las.
Passo 7. Revise as informações da sua Infraestrutura. Caso necessário, clique no botão 'Editar' para fazer ajustes;
Passo 8. Clique em 'Executar' para subir a Infraestrutura para o repositório.
Pronto, você criou uma Infraestrutura via Portal da StackSpot EDP.
- Quando você cria a Infraestrutura via Portal, ela é registrada automaticamente no Workspace.
- O deploy da Infraestrutura só será realizado nesse momento se sua organização tiver configurado o deploy via Runtime Self-Hosted.
Acompanhar a execução do Workflow de criação da Infraestrutura
Após clicar no botão 'Executar', você será redirecionado para a tela de acompanhamento do Workflow de criação da Infraestrutura (Create Infra). Nessa tela, você pode visualizar e monitorar todos os jobs e steps do Workflow diretamente pela plataforma, como na imagem a seguir:
- Os jobs e steps são interativos e clicáveis.
- Para acessar os logs, clique em "View log" no respectivo step do Workflow.
Aprovação de Steps no Workflow
Alguns Workflows incluem steps de aprovação, que precisam ser aceitos para permitir a execução do deploy da Infraestrutura. Esses steps são exibidos na tela de acompanhamento do Workflow com o status "Check Approval" ou "Approval Response", como na imagem a seguir:
Como realizar a aprovação
A aprovação deve ser realizada por uma pessoa com permissão para aprovar no Workspace. Essa pessoa deve acessar a tela de acompanhamento do Workflow da Infraestrutura e aceitar o(s) step(s) de aprovação necessário(s).
Um Workflow pode conter múltiplos steps de aprovação, e cada step deve ser aceito individualmente para que o Workflow possa avançar para as próximas etapas.
Próximos passos
- Gerencie e acompanhe sua Infraestrutura.
- Para destruir sua Infraestrutura, confira a seção de Destroy.