Adicionar Workflow na Stack

Nesta seção, você encontra um guia de como adicionar um Workflow em uma versão da Stack na StackSpot.

Visão Geral

Você pode adicionar um Workflow a uma versão de Stack usando o Portal da StackSpot EDP ou o STK CLI.

Tipos de versionamento

Ao adicionar um Workflow, você pode escolher entre dois tipos de versionamento:

1. Por versão semântica específica (major, minor e revision, sendo os dois últimos opcionais). Confira um exemplo: <studio>/<workflow>@1.0.0;

2. Por range de versões, como por exemplo, <studio>/<workflow>@1, <studio>/<workflow>@1.1, <studio>/<workflow>@~1.0.0.

Além disso, um Workflow pode conter uma dependência de Plugin, Action ou até de outro Workflow.

Se um Workflow depende de um Plugin do tipo Infra, quando o Workflow é adicionado na Stack, as dependências do Plugin deste tipo também precisam ser adicionadas à ela. E isso é feito de forma automática pela StackSpot.

A exceção disso acontece quando o mesmo Plugin de Infra já está publicado na Stack, mas em uma range ou versão diferente da que o Workflow depende. Neste caso é preciso resolver manualmente essa inconsistência para conseguir publicar a Stack.

Confira os passos para adicionar um Workflow na Stack via Portal da StackSpot EDP.

Passo a passo

É possível adicionar a versão de um Workflow de uma Stack enquanto ela ainda está em rascunho (Draft).

Passo 1. No Portal da StackSpot EDP, entre no seu Estúdio e procure a Stack que você quer adicionar um Workflow;

Passo 2. Na sua Stack, clique na aba 'Workflows';

Passo 3. Clique no botão 'Adicionar Workflow';

Passo 4. No menu 'Adicionar Workflow', você terá acesso aos Workflows disponíveis nas abas 'Workflows do Estúdio', 'Workflows da conta' e 'Inserir Qualifier';

Passo 5. Selecione, na aba escolhida, o 'Workflow' e a 'versão' ou 'range de versões';

Passo 6. Para finalizar, clique no botão 'Adicionar Workflow'.

Pronto, você adicionou um Workflow em uma versão da Stack, o próximo passo é clicar no botão 'Publicar' para que a versão da Stack que você adicionou o Workflow fique disponível para uso.

Deletar uma versão

Você pode deletar a versão de um Workflow de uma Stack enquanto ela ainda está em rascunho (Draft).

Passo 1. Na aba 'Workflows’, dentro da sua Stack, clique no botão de mais detalhes;

Passo 2. Clique na opção ’Delete Workflow';

Passo 3. Para confirmar, clique no botão 'Delete'.

Pronto, você deletou a versão de um Workflow em uma Stack.

Adicionar Workflow no yaml da Stack via STK CLI

É possível adicionar um Workflow no schema (yaml) da sua Stack, através do STK CLI.

Confira a seguir um exemplo de yaml da Stack com Workflow:

schema-version: v1
kind: stack
metadata:
  name: stack-cli            #obrigatório
  display-name: Stack Cli              #obrigatório
  description: test stack publish by cli             #obrigatório
  version: 1.0.0              #obrigatório
  picture: images/logo.jpg
  tags:
    - cli
spec:
  repository: https://github.com/stack-spot/stack-cli
  docs:                               #obrigatório
    en-us: docs/en_us/docs.md             #obrigatório pelo menos 1 idioma
    pt-br: docs/pt_br/docs.md             #obrigatório pelo menos 1 idioma
  links:
    - name: Link legal
      url: https://stackspot.com/
      picture: images/logo.jpg
    - name: Link legal2
      url: https://stackspot.com/
      picture: https://stackspot.com/logo.png
  plugins:
    app:
      - name: cli/plugin-1@1.1.1
      - name: cli/plugin-2@~1.1.0
      - name: cli/plugin-3@1.1.1
    infra:
      - name: infra/plugin-4@1.1.1
        actions:
          - name: cli/action-shell-1
      - name: infra/plugin-5@~1.1.0
      - name: infra/plugin-6@1.1.1
  actions:
    - name: cli/action-shell-1@1.0.1
    - name: cli/action-shell-2@1.0.1
    - name: cli/action-shell-3@~1.0.0
  workflows:
    - name: studio-a/workflow-1@1.1.1
    - name: studio-a/workflow-2@1.0.1
    - name: studio-a/workflow-3@1.0.0