Instalação em Pipelines
Para instalar e autenticar o STK CLI em uma pipeline, você precisa antes possuir uma conta StackSpot Enterprise.
Requisitos
Veja abaixo os requisitos para usar o STK CLI em uma pipeline CI/CD:
- Possuir uma conta Enterprise no Portal da StackSpot.
A instalação ainda é possível sem uma conta Enterprise, mas você não terá acesso aos recursos exclusivos para contas Enterprise.
Instalação via curl na pipeline
Para usar a StackSpot em uma pipeline, é necessário usar a instalação via curl. Para isso, é preciso ter uma conta StackSpot. Em seguida, siga os passos abaixo:
1. Faça o login no Portal da StackSpot;
2. Acesse a página de Download para ter acesso ao comando curl:
curl -fsSL https://stk.stackspot.com/install.sh | bash && exec $SHELL
A instalação via curl também funciona para uso local mas apenas em sistemas Unix, como Linux e MacOS.
Usar uma imagem Docker com o STK CLI instalado
Você pode usar uma imagem Docker com o STK CLI instalado. A StackSpot disponibiliza duas versões do Linux, nas seguintes distribuições:
Para utilizar a imagem, faça o pull da imagem com o comando encontrado no campo Docker Pull Command no repositório de cada imagem.
Depois de usar a imagem Docker com o STK CLI, execute o comando abaixo para autenticar o STK CLI:
Execute o comando abaixo sem as chaves < >.
Para obter os valores de client-id, client-key e realm, consulte o passo para Obter as chaves e autenticar pelo terminal.
stk-legacy login --client-id <ID> --client-key <KEY> --realm <REALM>
Autenticar via CI/CD para conta Enterprise
As contas Enterprise suportam a autenticação do STK CLI via linha de comando, utilizando um client id e um client key.
Esse tipo de autenticação possibilita manter uma sessão ativa com um tempo de expiração configurável, para usar o STK CLI via linha de comando, como por exemplo, em pipelines de CI/CD.
O tempo de expiração da sessão atualmente é de 20 minutos. Em breve esse valor será configurável através do Portal da StackSpot.
Obter as chaves e autenticar pelo terminal
Para autenticar pelo terminal, é necessário obter no Portal StackSpot as chaves para serem informadas no terminal junto do comando stk-legacy login. Para isso, siga os passos abaixo:
Passo 1. Faça o login no Portal da StackSpot;
Passo 2. No menu superior, acesse a opção Configurações e em seguida, clique em Tokens de Acesso:
Passo 3. Na tela Client Secret, clique no botão Gerar chave do cliente para visualizar todas as chaves necessárias:
As chaves são geradas por usuário da organização, se um usuário gerar uma nova chave a anterior automaticamente se tornará inválida. Gerar uma nova chave não invalida as chaves de outros usuários dessa organização.
Passo 4. No terminal, execute o comando abaixo subistuindo os valores entre chaves pelos valores obtidos nos passos anteriores:
Execute o comando abaixo sem as chaves < >
stk-legacy login --client-id <ID> --client-key <KEY> --realm <REALM>
Esta página foi útil?