Criar na sua nuvem

Com uma conta de nuvem conectada, o GoShip cria a máquina por você: você escolhe a região e o tamanho, e ele cria a máquina na sua conta, instala o k3s nela e registra o cluster. O provedor cobra a máquina direto de você; o GoShip cobra só o cluster, pela capacidade (Cobrança).

Antes de começar

• Uma conta de nuvem conectada: DigitalOcean, Hetzner Cloud, Latitude.sh, AWS ou Google Cloud. Sem nenhuma, Add cluster te manda para Contas de nuvem, com um atalho para seguir mesmo assim com um servidor seu.
• Ser dono ou administrador da organização.
• Um cartão válido do dono da organização, exigido antes de a máquina ser criada (o período de avaliação por convite dispensa, e o cluster não é cobrado nele).
• Todo cluster precisa de pelo menos 2 vCPU, 4 GB de RAM e 30 GB de disco; tamanhos abaixo disso não aparecem.

Pelo painel

Em Clusters, no grupo Infrastructure da barra lateral, clique em Add cluster. As seções carregam da API do provedor, ao vivo:

1. Where: uma entrada por conta de nuvem conectada, com o nome (label) dela. My server (Conectar um servidor) e Kubernetes (Conectar Kubernetes) aparecem na mesma lista.
2. Region: as regiões da conta escolhida.
3. Size: uma tabela com vCPU, memória, disco, o preço do provedor (na moeda dele, quem cobra é ele) e a faixa do GoShip em reais para aquele tamanho.
4. Name: vem preenchido, pode trocar.

O Summary resume a escolha. Depois de Add cluster, a página do cluster mostra o andamento em etapas: Creating the machine · Waiting for SSH · Installing k3s · Registering with GoShip · Measuring capacity.

Pela CLI

goship cloud regions <conta>
goship cloud sizes <conta> --region <slug>
goship cluster create meu-cluster --cloud <conta> --region <slug> --size <slug>

--cloud aceita o id ou o nome da conta. Sem --region ou --size num terminal interativo, o comando pergunta, escolhendo da lista ao vivo; em script, passe os dois. O comando acompanha as etapas até o cluster ficar active, ou sai com código 1 se alguma falhar. --no-wait devolve na hora, sem acompanhar; --timeout limita quanto tempo ele acompanha (30 minutos por padrão; o cluster continua sendo criado de qualquer jeito); -o json imprime o cluster.

Depois de criar

O cluster é da organização e ainda não roda nada: um ambiente precisa apontar para ele. Para apontar ambientes que já existem na mesma hora, passe --environment <slug> ao criar (--environment development --environment production): eles passam a rodar nele assim que ficar active.

goship environment create qa --cluster meu-cluster

• Mudar o tamanho da máquina sem recriar o cluster: Mudar o tamanho de um cluster.
• Remover: goship cluster rm meu-cluster --destroy-server desconecta o cluster e destrói a máquina na sua conta. Sem --destroy-server a máquina continua rodando e sendo cobrada pelo provedor (Visão geral → Remover um cluster).
• O que o GoShip cria na sua conta, por provedor: em Contas de nuvem.

Volumes

Todo cluster criado na sua nuvem oferece disco local para volumes assim que entra no ar, sem nada a configurar. Veja Apps → Volumes.

Em clusters na DigitalOcean também existe o block storage da DigitalOcean: na página do cluster, Enable volumes instala o driver usando a conta DigitalOcean conectada (nenhum token é pedido ali), e Reinstall driver repete a instalação.

Volumes na DigitalOcean por OAuth: clusters criados a partir de uma conta DigitalOcean conectada por OAuth ainda não habilitam block storage. Falta um renovador para o token OAuth, que está a caminho. Enquanto isso, esses clusters oferecem só disco local.