Code-Hero: Automatize com a CLI

Inicie o Code-Hero, recupere as suas credenciais e altere a sua configuração programaticamente com a Stackhero CLI

👋 Bem-vindo à documentação da Stackhero!

A Stackhero oferece Code-Hero, uma plataforma de desenvolvimento completa para codificar em segundos:

Codifique de qualquer lugar: Utilize qualquer dispositivo, seja um desktop, telefone ou tablet, sem necessidade de instalações de software.

Experiência VSCode integrada: Trabalhe com uma versão personalizada do VSCode diretamente através do seu navegador, com um terminal totalmente funcional.

Conjunto de ferramentas abrangente: Beneficie de um ambiente pré-configurado com ferramentas e linguagens como Docker, Git, Zsh, Node.js, Go, Python, Ruby, e mais.

Conectividade perfeita: Aceda às suas aplicações de desenvolvimento via HTTPS num domínio público, imitando condições de produção. Esta configuração suporta webhooks e integrações externas sem esforço.

Experimente a eficiência e conveniência da solução cloud de desenvolvimento Code-Hero da Stackhero. Leva apenas 5 minutos para começar! Simplifique os seus processos de desenvolvimento e poupe tempo valioso hoje.

Este guia mostra-lhe como criar um serviço Code-Hero, ler as suas credenciais e atualizar a sua configuração totalmente a partir da linha de comandos, sem necessidade de clicar no dashboard. É ideal para scripts, pipelines de CI e agentes de IA.

Vamos utilizar a Stackhero CLI para todas as tarefas. Se ainda não o fez, pode instalá-la com:

curl -fsSL https://www.stackhero.io/install.sh | sh

1. Autenticação

A forma mais simples de começar é iniciar sessão através do seu navegador. Quando executa o comando de login, a CLI abre uma página web onde pode aprovar o acesso. Não é necessário introduzir passwords ou códigos 2FA diretamente na CLI.

stackhero login

Após iniciar sessão, as suas credenciais ficam guardadas localmente e serão utilizadas automaticamente nos próximos comandos da CLI.

Para ambientes totalmente automatizados, como scripts ou pipelines de CI, poderá preferir um token de acesso não interativo. Pode criar um a partir do seu dashboard (Conta > Access tokens) e exportá-lo como variável de ambiente. A CLI, assim como qualquer script que execute, irá detetá-lo automaticamente.

export STACKHERO_TOKEN="usr-xxxxxx:your-token"

2. Encontrar o serviço store do Code-Hero

De seguida, irá querer listar os serviços store Code-Hero disponíveis na sua conta. A CLI aceita diretamente o nome do store (code-hero), pelo que não é necessário procurar ou copiar IDs.

# Listar os serviços store Code-Hero (adicione --organization se gerir mais do que um)
stackhero services-store-list --name="code-hero"

Pode referir-se ao nome do store code-hero nos comandos seguintes, ou escolher um ID específico svs-xxxxxx da lista, se preferir.

3. Escolher um tamanho de instância e uma região

# Listar tamanhos de instância para o seu serviço store (utilize a coluna NAME para --instance)
stackhero instances-store-list --service-store=code-hero

# Listar regiões disponíveis (nomes como "europe")
stackhero regions-list

4. Criar o serviço

Segue-se um exemplo de script que cria um stack, adiciona o seu serviço Code-Hero, aguarda que este inicie, recupera a sua configuração (incluindo as credenciais geradas) e depois aplica uma nova configuração.

#!/bin/bash
set -e

export STACKHERO_TOKEN="usr-xxxxxx:your-token"

serviceStore="code-hero"   # O nome do serviço store Code-Hero (ver passo 2)
instance="..."                # Um tamanho de instância do passo 3
region="europe"               # Um nome de região do passo 3

# Criar um stack para o seu serviço (utiliza a sua organização por defeito; adicione --organization se necessário)
stackId=$(stackhero --format=script stack-create \
  --name="My Code-Hero stack")
echo "Stack criado: ${stackId}"

# Adicionar Code-Hero ao stack (os nomes são resolvidos automaticamente)
serviceId=$(stackhero --format=script service-add \
  --stack="My Code-Hero stack" \
  --service-store="${serviceStore}" \
  --instance="${instance}" \
  --region="${region}")
echo "Serviço adicionado: code-hero"

# Aguardar que o serviço esteja totalmente operacional (pode demorar alguns minutos)
stackhero service-wait-for --service="code-hero"

# Recuperar a configuração do serviço, incluindo as credenciais geradas
stackhero service-configuration-get --service="code-hero" --format=json

5. Recuperar credenciais

O comando service-configuration-get devolve a configuração completa do seu serviço, incluindo passwords geradas automaticamente e detalhes de ligação. O resultado é em formato JSON, facilitando a utilização em scripts e automação.

stackhero service-configuration-get --service=svc-xxxxxx --format=json

6. Alterar a configuração

Pode consultar um exemplo de esquema de configuração e depois aplicar as suas próprias definições. Ao atualizar a configuração, o serviço pode reiniciar para aplicar as alterações.

# Ver o esquema de configuração e um exemplo para o seu serviço
stackhero service-configuration-example --service=svc-xxxxxx

# Aplicar uma configuração personalizada (o serviço reinicia se necessário)
stackhero service-configuration-set \
  --service=svc-xxxxxx \
  --configuration='{ "...": "..." }'

# Aguardar que a nova configuração seja aplicada
stackhero service-wait-for --service=svc-xxxxxx

E está feito. Acabou de ver todo o ciclo de vida: iniciar um serviço, recuperar as suas credenciais e reconfigurá-lo, tudo de forma automatizada e scriptável. Para saber mais, consulte a documentação completa da CLI, que também cobre a autenticação não interativa com STACKHERO_TOKEN demonstrada aqui.