Comandos de Stack
Nesta seção, você encontra instruções detalhadas sobre os comandos para gerenciar Stacks utilizando o STK CLI.
| Comando | Descrição |
|---|---|
| stk create stack | Cria uma Stack pelo STK CLI. |
| stk list stack | Lista todas as Stacks em um Workspace ou Estúdio. |
| stk validate stack | Valida a estrutura de uma Stack antes da publicação. |
| stk publish stack | Publica sua Stack usando o STK CLI. |
stk create stack
O comando stk create stack cria a estrutura básica de uma Stack.
A opção -o ou --target permite definir um nome de pasta diferente para criar o conteúdo da Stack. Se a pasta não existir, ela será criada automaticamente.
Caso não utilize a opção -o ou --target, o nome da pasta será o mesmo nome informado para a Stack.
Uso
Sintaxe
stk create stack [NOME]
Exemplo
stk create stack minha-stack
Parâmetros
| Opção | Descrição | Exemplo |
|---|---|---|
-d, --description | Descreva sua Stack. | stk create stack minha-stack --description "Minha Stack de exemplo" |
-v, --version | Defina a versão semântica da Stack. | stk create stack minha-stack --version 1.3.0 |
-r, --remote | Informe a URL do repositório Git remoto (origin). | stk create stack minha-stack --remote https://github.com/MinhaOrg/meu-repo |
-sgi, --skip-git-init | Não inicializa um repositório Git ao criar a Stack. | stk create stack minha-stack --skip-git-init |
-q, --non-interactive | Executa o comando sem perguntas interativas. Erro se faltar input obrigatório. | stk create stack minha-stack --non-interactive |
-o, --target | Define uma pasta específica para criar o conteúdo da Stack. | stk create stack minha-stack --target /caminho/stack |
-f, --from | Gera a Stack a partir de outra Stack existente. | stk create stack --from meu-estudio/outra-stack@1.0.0 |
-h, --help | Exibe a ajuda do comando. | stk create stack --help |
stk list stack
O comando stk list stack exibe no terminal as Stacks disponíveis.
Você pode:
- Listar as Stacks de um Workspace. Neste caso, acesse primeiro o Workspace desejado com o comando stk use workspace.
- Listar Stacks fora de um Workspace, informando um Estúdio. Assim, o comando lista todas as Stacks públicas desse Estúdio.
Você visualiza o nome, tipo, descrição e versão da Stack. O comando também sinaliza se alguma Stack está depreciada com a tag 'deprecated'.
Uso
Sintaxe
stk list stack
Para listar as Stacks fora de um Workspace, informe o Estúdio:
stk list stack --studio meu-estudio-slug
Parâmetros
| Opção | Descrição | Exemplo |
|---|---|---|
-stu, --studio | Slug do Estúdio para listar Stacks fora de um Workspace. | stk list stack --studio meu-estudio-slug |
-h, --help | Exibe a ajuda do comando. | stk list stack --help |
stk validate stack
O comando stk validate stack valida a estrutura da Stack e seus componentes. Arquivos ignorados no .gitignore não são validados.
Uso
Sintaxe
stk validate stack
Exemplo
No diretório da Stack, execute:
stk validate stack
Parâmetros
| Opção | Descrição | Exemplo |
|---|---|---|
-v, --verbose | Exibe detalhes avançados durante a validação. | stk validate stack --verbose |
-stu, --studio | Valida a Stack considerando informações da Stack publicada, usando o slug do Estúdio. | stk validate stack --verbose --studio meu-estudio-slug |
-h, --help | Exibe a ajuda do comando. | stk validate stack --help |
stk publish stack
O comando stk publish stack publica a Stack para o Estúdio informado usando o STK CLI.
Arquivos listados no .stkignore não são publicados na StackSpot, mas continuam em commits Git caso não estejam no .gitignore.
Uso
Sintaxe
stk publish stack [OPÇÕES] --studio [STUDIO-SLUG]
Exemplo
No diretório da Stack, execute:
stk publish stack --studio meu-estudio-slug
Parâmetros
| Opção | Descrição | Exemplo |
|---|---|---|
-s, --studio | Nome do Estúdio para publicação da Stack. | stk publish stack --studio meu-estudio |
-v, --verbose | Exibe detalhes avançados durante a publicação. | stk publish stack --verbose --studio meu-estudio |
-h, --help | Exibe a ajuda do comando. | stk publish stack --help |
Leia também