Deploy

    Deploy pelo GitHub ou Forgejo na Zenifra

    Conecte repositórios GitHub ou Forgejo e publique manualmente ou automatize deploys por branch, tag ou release.

    Escolha sua origem GitHub ou Forgejo

    Escolha um repositório para publicar sua aplicação. As etapas de conexão e as permissões variam conforme o provedor.

    GitHub

    Conecte sua conta GitHub, selecione a organização e o repositório e escolha a branch de origem.

    • Autorize o acesso à sua conta GitHub.
    • Publique manualmente ou automatize por branch, tag ou release; pré-lançamentos são opcionais no modo por release.
    • Runtimes: Node.js, Python e Bun.
    Ler docs de GitHub

    Forgejo

    Informe o endereço HTTPS da instância Forgejo. O certificado precisa ser válido e a instância, acessível pela Zenifra. Depois, informe o caminho do repositório.

    • Para publicação manual, use um token com acesso de leitura ao repositório. Para automação, conceda também acesso de escrita e permissão para administrar os webhooks do repositório.
    • Publique manualmente ou inicie deploy por push na branch, tag ou release; pré-lançamentos são opcionais e só entram no modo por release quando ativados.
    • O deploy pelo Forgejo não cria um ambiente de preview para cada Pull Request.
    • Runtimes: Node.js, Python e Bun.
    Ler docs de Forgejo

    Deploy do GitHub por branch, tag ou release

    Configure publicações manuais ou automáticas do GitHub por branch, tag ou release, de acordo com o fluxo da sua equipe.

    Runtimes do GitHub

    Node.js (20 a 26), Python (3.11 a 3.14) e Bun (1.2 a 1.4) estão disponíveis no deploy por GitHub. Para aplicações fora desses runtimes, use uma imagem Docker/OCI.

    Conecte sua conta GitHub e escolha organização e repositório

    A branch selecionada continua sendo a origem para criar o projeto

    O deploy manual está sempre disponível

    No modo por branch, pushes na branch configurada iniciam o deploy

    No modo por tag, use o padrão comum a tags e releases: correspondência exata, como v1.2.3, ou curingas * e ?, como v*

    No modo por release, o padrão compara o nome da tag associada, não o título; pré-lançamentos só podem ser incluídos com a opção ativada

    Como escolher a publicação

    O deploy manual está sempre disponível, mesmo quando você configura um modo automático. A branch selecionada continua sendo a origem para criar o projeto; no modo por branch, pushes nessa branch iniciam o deploy. O mesmo padrão de tag vale para os modos por tag e por release. Use uma correspondência exata, como v1.2.3, ou curingas * e ?, por exemplo v*. No modo por release, a correspondência usa o nome da tag associada, não o título do release. Pré-lançamentos são opcionais e só podem ser incluídos no modo por release.

    Quando usar deploy pelo GitHub

    Publique manualmente quando estiver pronto ou automatize a publicação por branch, tag ou release publicado.

    Publicação manual

    Inicie um deploy quando estiver pronto, mesmo se houver um modo automático configurado.

    Automação por branch, tag ou release

    Escolha o evento de publicação que combina com o fluxo do time e acompanhe o status no console.

    APIs Node.js, Python e Bun

    Use os runtimes disponíveis no deploy por GitHub, com builds e logs no console.

    Como o fluxo GitHub funciona

    Conecte o repositório, escolha a origem inicial e configure como iniciar cada publicação automática.

    01

    Conecte GitHub

    Autorize o acesso e escolha organização, repositório e branch de origem para criar o projeto.

    02

    Escolha como publicar

    Mantenha o deploy manual ou configure a automação por branch, tag ou release publicado.

    03

    Configure e acompanhe

    Defina runtime e opções de tag ou release e acompanhe builds, logs e status no console.

    Configurações de publicação

    Escolha quando publicar e configure o runtime e as opções necessárias para sua aplicação.

    Modo de publicação

    O deploy manual está sempre disponível; a automação pode acompanhar branch, tag ou release publicado.

    Branch de origem

    A branch selecionada segue como origem para criar o projeto. No modo automático por branch, pushes nela iniciam o deploy.

    Padrão de tag

    O mesmo padrão vale para tags e releases. Use a tag exata v1.2.3 ou curingas * e ?, como v*.

    Releases publicados

    O padrão compara o nome da tag associada ao release, não seu título. A inclusão de pré-lançamentos é opcional e só existe nesse modo.

    Fluxo GitHub real no console

    Autorize o GitHub, escolha organização e repositório e confirme a branch que será usada para criar o projeto. Depois, mantenha deploy manual ou escolha automação por branch, tag ou release e acompanhe builds, logs e status no console.

    • Conectar GitHub e autorizar acesso ao repositório
    • Selecionar a branch de origem para criar o projeto
    • Manter deploy manual ou escolher automação por branch, tag ou release
    • Para tags e releases, definir o mesmo padrão, como v1.2.3 ou v*; pré-lançamentos só podem ser incluídos no modo por release
    • Escolher runtime Node.js, Python ou Bun e configurar comando, variáveis de ambiente e porta HTTP

    Conexão GitHub

    A tela deve mostrar organização, repositório, branch de origem para a criação do projeto, runtime e opção de publicação automática.

    Dúvidas frequentes

    Respostas sobre conexão e publicação pelo GitHub e Forgejo.

    O deploy manual continua disponível com a automação ativa?

    Sim. O deploy manual está sempre disponível, mesmo quando você configura publicação automática por branch, tag ou release.

    Como a publicação automática do GitHub pode começar?

    Escolha a branch configurada, uma tag que corresponda ao padrão definido ou um release publicado cuja tag associada corresponda ao mesmo padrão.

    Quais padrões de tag posso usar no GitHub?

    O padrão é o mesmo para tags e releases. Você pode usar uma tag exata, como v1.2.3, ou curingas * e ?, como v*. Em releases, ele compara o nome da tag associada, não o título.

    Posso incluir pré-lançamentos?

    Sim. A inclusão é opcional e pode ser ativada somente quando o modo por release está selecionado.

    Quais runtimes estão disponíveis?

    Os fluxos GitHub e Forgejo usam Node.js, Python e Bun. Para outros runtimes, use uma imagem Docker/OCI.

    Como conecto um repositório Forgejo?

    Informe o endereço HTTPS da instância e o caminho do repositório. O deploy manual precisa de token com acesso de leitura; a automação também requer acesso de escrita e permissão para administrar os webhooks do repositório.

    Respeitamos sua privacidade

    Usamos cookies essenciais para o funcionamento do site. Cookies de medição e marketing, como Google Ads, só serão ativados se você aceitar todos. Consulte nossa política de cookies.