Carregando
0x90Lição 10 de 14

Secrets, permissões e deploys

Use secrets e variáveis com segurança, dê ao GITHUB_TOKEN a menor permissão possível, controle os deploys com environments e publique com o GitHub Pages.

28 min Questionário com 7 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • Guardar e usar secrets e variáveis em workflows sem vazá-los
  • Limitar o que o GITHUB_TOKEN pode fazer e preferir OIDC a chaves de nuvem de longa duração
  • Fazer deploy por environments protegidos, agendar jobs e publicar um site com o GitHub Pages

Fazer o deploy da demo web do Dungeon Dash exige credenciais, e as credenciais nunca podem morar no repositório. Em vez disso:

  • Os secrets (Settings → Secrets and variables → Actions) são valores criptografados, disponíveis para os workflows como ${{ secrets.NAME }}. Eles são mascarados nos logs - impressos como ***.
  • As variáveis (${{ vars.NAME }}) guardam configurações não secretas, como o nome de um servidor.
  • Os secrets podem pertencer a um repositório, a uma organização (compartilhados por muitos repositórios) ou a um environment.
.github/workflows/deploy.yml
1name: Deploy demo
2on:
3  push:
4    branches: [main]
5
6permissions:
7  contents: read            # least privilege for the GITHUB_TOKEN
8
9jobs:
10  deploy:
11    runs-on: ubuntu-latest
12    environment: production  # protected: needs approval, has its own secrets
13    steps:
14      - uses: actions/checkout@v4
15      - run: ./scripts/deploy.sh "${{ vars.DEMO_HOST }}"
16        env:
17          DEPLOY_TOKEN: ${{ secrets.DEPLOY_TOKEN }}

Pontos que vale notar:

  • O secret chega ao script como uma variável de ambiente, e não colado na linha de comando, onde poderia aparecer em listagens de processos ou em logs.
  • permissions: limita o GITHUB_TOKEN automático que toda execução recebe. O padrão dele pode ser amplo; conceder só contents: read significa que um step comprometido não consegue fazer push de código nem editar releases. Acrescente o que um job realmente precisa: pull-requests: write para comentar em PRs, packages: write para publicar pacotes.
  • environment: production liga o job a um environment, que pode exigir a aprovação de um revisor antes de rodar, restringir quais branches podem fazer deploy e ter os seus próprios secrets.
  • Os secrets não são passados para workflows disparados por pull requests vindos de forks - senão qualquer pessoa poderia abrir um PR que imprime os seus secrets.
masking.py
1secrets = {"DEPLOY_TOKEN": "ghp_4f9Xk2", "DB_PASSWORD": "dragon$fire"}
2log = """Deploying to demo.dungeondash.dev
3Using token ghp_4f9Xk2 for auth
4Connecting with password dragon$fire
5Done"""
6for value in sorted(secrets.values(), key=len, reverse=True):
7    log = log.replace(value, "***")
8print(log)
Saída
Deploying to demo.dungeondash.dev
Using token *** for auth
Connecting with password ***
Done

Agendamentos e GitHub Pages

Os workflows agendados usam a sintaxe do cron - cinco campos: minuto, hora, dia do mês, mês, dia da semana (0 = domingo) - sempre em UTC. 0 3 * * 1 é 03:00 toda segunda-feira; */15 * * * * é a cada 15 minutos (o menor intervalo que o GitHub permite é de 5 minutos, e as execuções agendadas podem começar um pouco atrasadas).

O GitHub Pages hospeda sites estáticos de graça, direto de um repositório: documentação de projetos, um portfólio ou a demo web do Dungeon Dash. Gere o site num workflow com actions/upload-pages-artifact, faça o deploy com actions/deploy-pages, e ele aparece em https://OWNER.github.io/REPO/.

Principais conclusões

  • Guarde as credenciais nos secrets do Actions (mascarados nos logs) e as configurações simples em variáveis.

  • Defina permissions: para o GITHUB_TOKEN ter só o que cada job precisa; prefira OIDC a chaves de nuvem.

  • Environments protegidos acrescentam aprovações, regras de branch e secrets próprios aos deploys.

  • Os agendamentos cron rodam em UTC; o GitHub Pages hospeda sites estáticos gerados por um workflow.

Quiz da aula

7 perguntas · aprovação com 5 acertos · até 50 XP

Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.

Pratique: automatize tarefas do GitHub com Python

O trabalho real no GitHub envolve muita automação pequena: conferir CODEOWNERS, expandir matrizes de build, atualizar versões, ler a API. Escreva esses utilitários em Python e execute-os com entradas de exemplo, localmente no navegador e sem precisar de conta no GitHub.

Exercício 1

Mascare os secrets

+25 XP

A entrada tem linhas de secret NAME=value, uma linha --- e depois um log de build. Imprima o log com cada ocorrência de cada valor de secret substituída por *** (substitua os secrets mais longos primeiro, para que um secret que contém outro seja mascarado por inteiro). Depois imprima masked N occurrences e, se algum secret aparecer codificado em base64 no log, warning: NAME appears base64-encoded.

  • Log de deploy
  • Secrets aninhados
main.py
Carregando editor…

O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.

Exercício 2

O agendamento dispara?

+25 XP

Cada linha de entrada é uma expressão cron entre aspas, seguida de uma data e hora em UTC: "0 3 * * 1" 2026-10-05 03:00. Imprima fires ou doesn’t fire para cada uma.

Suporte, em cada um dos cinco campos (minuto, hora, dia do mês, mês, dia da semana com 0 = domingo): *, números, listas separadas por vírgula 1,15, intervalos 1-5 e passos */15 ou 0-30/10. Como no cron padrão, quando tanto o dia do mês quanto o dia da semana são restritos (não *), basta casar com qualquer um dos dois.

  • Agendamentos
  • Dia do mês OU dia da semana
main.py
Carregando editor…

O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.

Dúvidas sobre esta lição

Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.

Carregando publicações…