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.
- 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.
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 oGITHUB_TOKENautomático que toda execução recebe. O padrão dele pode ser amplo; conceder sócontents: readsignifica que um step comprometido não consegue fazer push de código nem editar releases. Acrescente o que um job realmente precisa:pull-requests: writepara comentar em PRs,packages: writepara publicar pacotes.environment: productionliga 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.
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)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.
Mascare os secrets
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
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.
O agendamento dispara?
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
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…