Deploy
Faça o deploy de um app com o Codex: do repositório a um serviço no ar com o ubctl
O Codex só faz o deploy de um app se operar a Unbroker pelo ubctl. O Codex não hospeda o serviço. A Unbroker constrói e executa o app depois que o CLI cria ou atualiza o serviço que você indicar.
Revisado em 26 de outubro de 2026
O Codex hospeda o seu app?
Não. O Codex edita o repositório e pode executar o ubctl na sua máquina. A URL pública, o build e o processo no ar são do Unbroker Cloud Apps.
Instalar a skill não cria uma conta, não emite um token e não faz deploy de nada. A skill é um conjunto de instruções para o CLI ubctl.
O que você precisa
Você precisa do Pro da Unbroker para criar um token de API, do ubctl instalado localmente, de Node.js com npx e do Codex. O Pro custa $25 por mês e inclui um crédito de uso do mesmo valor. Criar ou deixar um serviço rodando pode gerar cobrança nesse plano.
Um token só de leitura basta para a primeira inspeção. Criar ou alterar um serviço pede um token de leitura e escrita, e permissão para administrar apps nessa organização. Use um repositório que não seja de produção na primeira tentativa.
Configuração
Instale o ubctl pelo guia do CLI, crie o token no Cloud e cole no prompt oculto de login. Depois confirme a organização. Esses comandos ficam no seu terminal. Não cole o token no Codex.
Instale a skill ubctl-ops para o Codex com o comando abaixo. É o comando publicado na documentação da Unbroker e no guia de início do CLI. O arquivo da skill está no repositório unbroker-app/ubctl. Feche e abra o Codex de novo para ele enxergar a skill. A primeira tarefa deve só listar projetos.
ubctl --version
ubctl login
ubctl whoami
ubctl doctor
npx skills@latest add unbroker-app/ubctl --skill ubctl-ops --agent codex --global --yes
$ubctl-ops Show the active Unbroker organization and list its projects.
Do not create or modify resources.Prompt de deploy para o Codex
Substitua cada valor entre colchetes antes de enviar este prompt. O prompt fica em inglês, que é o idioma da skill. O Codex deve revisar o framework, o comando de build, o comando de start e os nomes das variáveis que o app precisa.
Ele precisa esperar o deploy chegar a um estado terminal. Um deploy na fila não é um release pronto. O comando de espera documentado é ubctl apps deploy <serviceId> --wait.
$ubctl-ops Deploy this repository to Unbroker.
Use organization [organization name] and project [project ID].
Create a new service named [service name] from [Git repository URL]
and branch [branch]. You may create and deploy this service on Pro.
Do not modify other services or attach a custom domain.
Inspect the repository's framework, build command, start command
and required runtime variables. Tell me which secret keys I need
to enter in Cloud; do not ask me to paste their values into chat.
Wait for the deployment to finish, inspect any failure, and verify
the public application URL. Report the service ID, deployment ID,
tested URL and checks performed.Se um deploy falhar: deixe o Codex ler os logs
Peça ao Codex para ler o log do build e o log de runtime, e para nomear o passo que falhou antes de mudar qualquer coisa. Um restart, um reset de volume ou um tamanho maior não são uma correção universal.
Os comandos abaixo são os documentados para esperar, ler o log de um deploy e ler logs de runtime. Um rollback promove um deploy anterior. Ele não reconstrói o commit e não restaura um banco nem um volume.
ubctl apps deploy <serviceId> --wait
ubctl apps deployment <deploymentId> --log
ubctl apps services logs <serviceId>Mantenha os segredos fora do chat
Diga ao Codex quais nomes de variáveis criar. Coloque os valores no Cloud. Não cole tokens, URLs de banco nem senhas no prompt, num flag que fique no histórico, nem no repositório.
O ubctl doctor mostra a configuração sem imprimir o token. Prefira ubctl login, ou um token enviado por pipe para ubctl login --stdin, em vez de colocar o token na linha de comando. A mesma regra vale se você também conectar o servidor MCP do Codex que está documentado: o token fica numa variável de ambiente, não no chat.
Codex e Claude Code na Unbroker
Os dois agentes usam a mesma skill ubctl-ops e a mesma conta da Unbroker. Nenhum dos dois hospeda o app. A diferença documentada é como você instala e invoca a skill.
O Codex usa --agent codex e você invoca $ubctl-ops. O Claude Code usa --agent claude-code e você invoca /ubctl-ops. O prompt desta página é o do Claude Code com essa invocação trocada. Tokens de API continuam exigindo Pro nos dois agentes.
Perguntas frequentes
O Codex consegue fazer deploy de um app na Unbroker?
Sim, quando o ubctl está autenticado e a skill ubctl-ops está instalada para o Codex. O Codex faz o deploy criando ou atualizando um serviço da Unbroker. O app passa a rodar na Unbroker.
O Codex hospeda o app publicado?
Não. O Codex opera o CLI. A hospedagem, os builds e a URL pública são do Unbroker Cloud Apps.
Qual é o comando de instalação para o Codex?
O comando documentado é npx skills@latest add unbroker-app/ubctl --skill ubctl-ops --agent codex --global --yes. Depois reinicie o Codex e invoque a skill com $ubctl-ops.
Preciso do Pro?
Tokens de API exigem Pro. O Pro custa $25 por mês com um crédito de uso do mesmo valor. Criar recursos e deixar um serviço rodando pode somar uso além dessa mensalidade quando o crédito acaba. A skill sozinha não faz deploy de nada.