CLI · ComandosServiços

Serviços

Listar, inspecionar, fazer deploy e operar serviços.

eqs services ls

Lista os serviços de um space, com estado e origem: a imagem, ou o repositório a partir do qual o serviço é construído.

--space <slug>O space (por omissão: o space ativo, definido com eqs spaces use). Todos os comandos desta página aceitam-no

shell

eqs services ls --space my-space

eqs services get <svc>

Detalhes de um serviço: origem, porta, escala, o health check (o health path, ou um probe TCP) e onde responde: os domínios, o endereço do serviço primeiro (o nome escolhido sob o domínio da plataforma, quando existe), cada um marcado como endereço, gerado ou próprio, verificado ou não verificado, com ou sem TLS, e o gerado com o destino para onde redireciona e, para um serviço exposto numa porta TCP, o host:porta.

shell

eqs services get api-gateway

eqs services create <name>

Cria um serviço e faz o deploy a partir de uma origem: um repositório ligado (a stack é detetada, ou é construído um Dockerfile ou ficheiro Compose que ele contém), uma imagem já construída, ou um serviço do marketplace.

--repo <owner/name>Um repositório ligado, construído a partir de --branch (por omissão: main)

--dockerfile [path]Com --repo: build a partir de um Dockerfile (caminho por omissão: Dockerfile)

--composeCom --repo: build a partir de um ficheiro docker-compose

--image <ref>Uma imagem já construída

--catalog <code>Um serviço do marketplace: eqs services catalog lista-os, e --catalog-version escolhe a versão

--set <key=value>Com --catalog: o valor de um campo. Repetível

--port <n>A porta em que a aplicação escuta

--internalApenas interno, sem domínio público

--min <n>Mínimo de instâncias (0 = escala a zero)

--max <n>Máximo de instâncias

--domain <host>Associa um domínio próprio depois de o serviço ser criado

--health-path <path>O caminho do health check: um GET HTTP nele indica se uma instância está pronta. Sem ele, um probe TCP na porta

shell

eqs services create api --image registry.example/api:1.4 --port 8080 --health-path /healthz

eqs services update <svc>

Muda a imagem ou o health path de um serviço e inicia um rollout. Só muda o que for indicado, e sem nenhuma das opções o comando é recusado. Só se pode definir uma imagem num serviço implementado a partir de uma imagem.

--image <ref>A imagem a executar

--health-path <path>O caminho do health check; "" devolve o serviço ao probe TCP

shell

eqs services update api --health-path /healthz

eqs deploy <svc>

Dispara um novo deploy do serviço: um serviço construído a partir de um repositório é reconstruído (build → push → rollout), um implementado a partir de uma imagem volta a fazer o rollout dela. Termina assim que o rollout fica em fila, a não ser que se indique --wait.

--image <ref>Torna esta imagem a imagem do serviço e faz o rollout dela (um serviço implementado a partir de uma imagem)

--waitAcompanha o deploy que o comando iniciou, indicando cada estado por que passa. Sai com 0 quando está em execução, e com erro quando falha (imprimindo o seu log) ou quando nenhum começa num minuto

--timeout <minutes>Com --wait: quantos minutos o deploy pode demorar (por omissão: 30). Passado esse tempo, o comando indica o deploy e o estado em que está, e sai com erro

shell

eqs deploy api --image registry.example/api:1.5 --wait

eqs restart <svc>

Reinicia as instâncias do serviço.

shell

eqs restart web-frontend

eqs scale <svc>

Ajusta os limites de instâncias (mín–máx). v2.

--min <n>Mínimo (0 = escala a zero)

--max <n>Máximo

shell

eqs scale worker --min 1 --max 6

eqs env ls <svc> · eqs env set <svc> K=V · eqs env rm <svc> K · eqs env apply <svc>

Lista as variáveis de ambiente do serviço (só os nomes: os valores nunca são devolvidos), define ou remove uma, e faz o rollout delas.

--secretCom set: guarda o valor cifrado, num Secret

--applyCom set: faz já o rollout do serviço, em vez de deixar a alteração pendente

shell

eqs env set api-gateway LOG_LEVEL=debug

Guardar uma variável NÃO reinicia nada: as instâncias em execução ficam com o Secret com que foram renderizadas, e isso só muda num rollout. Defina o grupo todo e depois faça um rollout com eqs env apply <svc> — fazer rollout a cada gravação reiniciaria o serviço a meio de uma connection string. O eqs env pending <svc> diz se ainda falta um rollout, e limpa-se quando qualquer rollout apanhar as variáveis.