First commit - backup RDOC
This commit is contained in:
110
.github/SECRETS_SETUP.md
vendored
Normal file
110
.github/SECRETS_SETUP.md
vendored
Normal file
@@ -0,0 +1,110 @@
|
||||
# Configuração de Secrets para GitHub Actions
|
||||
|
||||
Para que a automação funcione corretamente, você precisa configurar os seguintes secrets no seu repositório GitHub:
|
||||
|
||||
## Como Configurar Secrets
|
||||
|
||||
1. Vá para o seu repositório no GitHub
|
||||
2. Clique em **Settings** (Configurações)
|
||||
3. No menu lateral, clique em **Secrets and variables** > **Actions**
|
||||
4. Clique em **New repository secret**
|
||||
5. Adicione cada secret listado abaixo
|
||||
|
||||
## Secrets Necessários
|
||||
|
||||
### 🔑 REMOTE_REPO_TOKEN
|
||||
**Descrição:** Token de acesso pessoal para o repositório remoto `https://github.com/Reifonas/TS_RDO.git`
|
||||
|
||||
**Como obter:**
|
||||
1. Vá para GitHub Settings > Developer settings > Personal access tokens > Tokens (classic)
|
||||
2. Clique em "Generate new token (classic)"
|
||||
3. Selecione as permissões:
|
||||
- `repo` (acesso completo a repositórios)
|
||||
- `workflow` (atualizar workflows)
|
||||
- `write:packages` (se usar packages)
|
||||
4. Copie o token gerado
|
||||
5. Cole no secret `REMOTE_REPO_TOKEN`
|
||||
|
||||
### 🌐 NETLIFY_AUTH_TOKEN (Opcional)
|
||||
**Descrição:** Token de autenticação do Netlify para deploy automático
|
||||
|
||||
**Como obter:**
|
||||
1. Faça login no Netlify
|
||||
2. Vá para User settings > Applications > Personal access tokens
|
||||
3. Clique em "New access token"
|
||||
4. Dê um nome e clique em "Generate token"
|
||||
5. Copie o token e cole no secret `NETLIFY_AUTH_TOKEN`
|
||||
|
||||
### 🆔 NETLIFY_SITE_ID (Opcional)
|
||||
**Descrição:** ID do site no Netlify
|
||||
|
||||
**Como obter:**
|
||||
1. No dashboard do Netlify, clique no seu site
|
||||
2. Vá para Site settings > General > Site details
|
||||
3. Copie o "Site ID"
|
||||
4. Cole no secret `NETLIFY_SITE_ID`
|
||||
|
||||
## Verificação da Configuração
|
||||
|
||||
Após configurar os secrets, você pode testar a automação:
|
||||
|
||||
1. **Teste Manual:**
|
||||
- Vá para Actions no seu repositório
|
||||
- Clique em "Auto Sync and Deploy"
|
||||
- Clique em "Run workflow"
|
||||
- Marque "Force deploy" se quiser forçar
|
||||
|
||||
2. **Teste Automático:**
|
||||
- Faça qualquer alteração no código
|
||||
- Commit e push para a branch main
|
||||
- A action será executada automaticamente
|
||||
|
||||
## Estrutura dos Secrets
|
||||
|
||||
```
|
||||
Repository Secrets:
|
||||
├── REMOTE_REPO_TOKEN # Token para repositório remoto (OBRIGATÓRIO)
|
||||
├── NETLIFY_AUTH_TOKEN # Token Netlify (opcional)
|
||||
├── NETLIFY_SITE_ID # ID do site Netlify (opcional)
|
||||
└── GITHUB_TOKEN # Automático (não precisa configurar)
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### ❌ Erro: "Authentication failed"
|
||||
- Verifique se o `REMOTE_REPO_TOKEN` está correto
|
||||
- Confirme se o token tem as permissões necessárias
|
||||
- Verifique se o token não expirou
|
||||
|
||||
### ❌ Erro: "Repository not found"
|
||||
- Confirme se o repositório `Reifonas/TS_RDO` existe
|
||||
- Verifique se o token tem acesso ao repositório
|
||||
|
||||
### ❌ Erro de Deploy Netlify
|
||||
- Verifique se `NETLIFY_AUTH_TOKEN` e `NETLIFY_SITE_ID` estão corretos
|
||||
- Confirme se o site existe no Netlify
|
||||
|
||||
## Logs e Monitoramento
|
||||
|
||||
Para acompanhar a execução:
|
||||
1. Vá para **Actions** no seu repositório
|
||||
2. Clique na execução desejada
|
||||
3. Expanda os jobs para ver os logs detalhados
|
||||
|
||||
## Segurança
|
||||
|
||||
⚠️ **IMPORTANTE:**
|
||||
- Nunca compartilhe seus tokens
|
||||
- Use tokens com permissões mínimas necessárias
|
||||
- Revogue tokens antigos quando não precisar mais
|
||||
- Monitore o uso dos tokens regularmente
|
||||
|
||||
## Frequência de Execução
|
||||
|
||||
A action executa:
|
||||
- ✅ A cada push na branch main ou develop
|
||||
- ✅ A cada pull request para main
|
||||
- ✅ A cada 30 minutos (agendado)
|
||||
- ✅ Manualmente quando solicitado
|
||||
|
||||
Para alterar a frequência, edite o arquivo `.github/workflows/auto-sync-deploy.yml`
|
||||
Reference in New Issue
Block a user