Comandos de Stack
Nesta seção você aprenderá mais sobre os comandos do Stacks.
Comando Descrição stk create stack Cria uma Stack com o STK CLI. stk list stack Lista todas as Stacks dentro de um Workspace. stk validate stack Valida a estrutura de uma Stack para ela ser publicada. stk publish stack Publica a sua Stack com o STK CLI.
stk create stack
O comando stk create stack cria a estrutura básica de uma Stack.
A opção -o, --target permite definir um nome de pasta diferente para criar o conteúdo da Stack. Se a pasta não existir, ela será criada.
Se você não usar a opção -o ou --target, o nome da pasta do conteúdo da Stack será o mesmo que você deu ao criar a sua Stack.
Uso
Sintaxe
stk create stack [NAME]
Exemplo
stk create stack my-stack-name
Parâmetros
| Opções | Descrição | Exemplo |
|---|---|---|
-d, --description | A descrição da sua Stack. | stk create stack my-stack-name --description "My Stack description" |
-v, --version | Versão semântica da sua Stack. | stk create stack my-stack-name --version 1.3.0 |
-r, --remote | URL Git que define o repositório remoto como origin. | stk create stack my-stack-name --remote https://github.com/MyGitHubOrg/my-repository |
-sgi, --skip-git-init | Não será inicializado um repositório Git. | stk create stack my-stack-name --skip-git-init |
-q, --non-interactive | Os inputs não informados não serão perguntados, retornando um erro se um input obrigatório não for fornecido. | stk create stack my-stack-name --non-interactive |
-o, --target | A opção -o, --target permite definir um nome de pasta diferente para criar o conteúdo da Stack. Se a pasta não existir, ela será criada. Se você não usar a opção -o ou --target, o nome da pasta do conteúdo da Stack será o mesmo que você deu ao criar a sua Stack. | stk create stack my-stack-name --description "My Stack description" --target home/user/documents/stack-name |
-f, --from | Gera o arquivo do Starter a partir de uma Stack existente. Use a seguinte sintaxe: stk create stack --from [studio-slug]/[stack-slug]@[semantic-version] | stk create stack --from my-other-studio/source-stack@1.0.0 |
-h, --help | Exibe a ajuda do comando e sai. | stk create stack --help |
stk list stack
O comando stk list stack lista no terminal as Stacks. Você tem duas opções:
-
Listar Stacks de um Workspace disponíveis para a sua conta. Nesse caso, você deve estar dentro de um Workspace, para isso, execute o comando stk use workspace antes de listar as Stacks.
-
Listar Stacks fora de um Workspace. Aqui, você precisa informar o Estúdio depois que executa o comando para listar todas as Stacks.
Você tem acesso ao nome, tipo, descrição e versão da Stack. E também avisa se tem Stack ou conteúdo depreciado com a tag
'deprecated'.
Uso
Sintaxe
stk list stack
Para listar as Stacks fora de um Workspace, informe um Estúdio para que o comando liste as Stacks:
Confira o exemplo:
stk list stack --studio java-dev-studio
Parâmetros
| Opções | Descrição | Exemplo |
|---|---|---|
-stu, --studio | Informe o Slug do Estúdio para listar as Stacks fora de um Workspace. | stk list stack --studio my-studio-slug |
-h, --help | Exibe a ajuda do comando e sai. | stk list stack --help |
stk validate stack
O comando stk validate stack valida a estrutura da sua Stack e seus componentes. Os arquivos ignorados em seu .gitignore não serão validados.
Uso
Sintaxe
stk validate stack
Exemplo
Dentro da pasta da sua Stack, execute o comando:
stk validate stack
Parâmetros
| Opções | Descrição | Exemplo |
|---|---|---|
-v, --verbose | Exibe a validação com mais detalhes. | stk validate stack --verbose |
-h, --help | Exibe a ajuda do comando e sai. | stk validate stack --help |
stk publish stack
O comando stk publish stack publica a sua Stack com o STK CLI.
Os arquivos listados no .stkignore não serão publicados na StackSpot, mas serão adicionados por commits do Git normalmente caso não sejam ignorados no .gitignore.
Uso
Sintaxe
stk publish stack [OPTIONS] --studio [STUDIO-SLUG]
Exemplo
Dentro da pasta da sua Stack, execute o comando:
stk publish stack --studio [STUDIO-SLUG]
Parâmetros
| Opções | Descrição | Exemplo |
|---|---|---|
-s, --studio | Nome do Estúdio onde será feita a publicação da Stack. | stk publish stack --studio my-studio |
-v, --verbose | Apresenta mais detalhes da publicação. | stk publish stack --verbose --studio my-studio |
-h, --help | Exibe a ajuda do comando e sai. | stk publish stack --help |