Pular para o conteúdo principal

Download e Instalação

Nesta seção, você encontra como instalar o STK CLI.


Sobre o STK CLI

O STK CLI é a ferramenta de interface de linha de comando (em inglês, CLI - Command Line Interface) da StackSpot. É o principal canal que permite você criar e usar conteúdos da StackSpot, além de acessar as demais funcionalidades da Plataforma.

O STK CLI possui comandos que facilitam o acesso e a criação dos recursos da StackSpot sem a necessidade de ambientes gráficos e interfaces complexas.

Antes de instalar:

Pré-Requisitos

Confira os requisitos para utilizar o STK CLI:

  • Para acessar todos os recursos disponíveis na StackSpot, você precisa ter uma conta e fazer o login para usar o STK CLI.

Configurar o seu usuário no Git

Após instalar o Git, você precisa configurar o usuário e e-mail da conta do seu repositório. No terminal, execute a sequência de comandos a seguir:

Passo 1. Configurar o seu nome de usuário e email

Nome:

git config --global user.name "{username}"

E-mail:

git config --global user.email "{email}"

Passo 2. Conferir a configuração

Execute na sequência os comandos:

git config --get user.name

Em seguida:

git config --get user.email

Se o seu nome de usuário e e-mail da conta do seu repositório Git foram exibidos no terminal, continue com o guia para fazer o download e a instalação do STK CLI a seguir. Caso não tenha um retorno ou for necessário corrigir alguma informação, repita o Passo 1.

Download e Instalação do STK CLI

Utilize o Git Bash para usar os comandos e assim ter uma melhor experiência (como a funcionalidade de auto-complete).


Para instalar a última versão do STK CLI:

  • Selecione o seu sistema operacional;
  • Faça o download; e
  • Siga os passos de instalação a seguir.

Download do instalador do Windows


O StackSpot CLI foi homologado para funcionar nas seguintes versões do Windows:

  • Windows 11
  • Windows 10

Link do instalador:


Passo 1. Seguir as instruções do wizard na sua máquina


Navegue para pasta onde você colocou o arquivo stk.msi. Clique duas vezes sobre o arquivo para começar a instalação. Siga as instruções do wizard na sua máquina e finalize a instalação.


Atenção!

Após a instalação caso você não tenha um proxy configurado, você deve informar ao STK CLI se deseja ou não configurar um proxy. O STK CLI irá perguntar no terminal sobre a configuração de proxy desejada.
Se você já possui um proxy configurado o STK CLI não vai exibir essa configuração.

Reiniciar o terminal após a instalação


Caso o terminal esteja aberto, feche e abra novamente após instalação, isso garante que o comando stk seja reconhecido.

No terminal execute o comando:

stk --version

Se tudo estiver configurado, o terminal irá retornar o número da versão atual do STK CLI.

Se o comando stk ainda não foi reconhecido, siga as instruções a seguir:

MacOS

No terminal do MacOS 'Zshell (zsh)', siga os passos a seguir:

1. Adicione as linhas no final do seu arquivo .zshrc, execute respectivamente os comandos:

export PATH=$HOME/.stk/bin:$PATH
test -f ~/.stk/bin/.zshrc && . ~/.stk/bin/.zshrc

2. Reinicie o terminal;

3. Execute o comando novamente:

stk -v

Linux

No terminal do Linux, siga os passos a seguir:

1. Execute o comando no seu terminal:

test -f ~/.stk/bin/.bash_profile && . ~/.stk/bin/.bash_profile

2. Reinicie o terminal;

3. Execute o comando novamente:

stk -v

Autenticar o STK CLI


Para autenticar o STK CLI, execute o comando:

stk login

Informe o e-mail cadastrado no Portal da StackSpot. No comando, você também pode informar o e-mail como parâmetro:

stk login email-account@email.com

Uma tela irá abrir no seu navegador padrão para que você informe o usuário e senha associados à conta. Após validar as informações e confirmar o login, retorne para o STK CLI onde a sua sessão será iniciada.

Alterar o idioma do STK CLI

O idioma exibido no STK CLI será o mesmo configurado em seu sistema operacional. Os idiomas suportados são Português e Inglês, mas se o seu sistema operacional estiver em um idioma diferente, o padrão será o Inglês.

  1. Para alterar o idioma, execute o comando a seguir:
stk config locale
  1. Selecione o idioma desejado.

Pronto!

Exemplo:

Próximos passos