diff --git a/.github/workflows/notify-discord.yml b/.github/workflows/notify-discord.yml index 1a5d4fd..317380e 100644 --- a/.github/workflows/notify-discord.yml +++ b/.github/workflows/notify-discord.yml @@ -12,8 +12,7 @@ jobs: env: DISCORD_WEBHOOK: ${{ secrets.DISCORD_WEBHOOK }} run: | - curl -X POST -H "Content-Type: application/json" \ - -d '{ + echo '{ "embeds": [{ "title": "📣 Nouvelle Pull Request : ${{ github.event.pull_request.title }}", "url": "${{ github.event.pull_request.html_url }}", @@ -22,7 +21,7 @@ jobs: "url": "https://github.com/${{ github.actor }}", "icon_url": "https://avatars.githubusercontent.com/${{ github.actor }}" }, - "description": "${{ github.event.pull_request.body || 'Aucune description.' }}", + "description": "'"${{ github.event.pull_request.body }}"'", "timestamp": "${{ github.event.pull_request.created_at }}", "footer": { "text": "${{ github.repository }}" @@ -41,5 +40,9 @@ jobs: } ] }] - }' \ - $DISCORD_WEBHOOK + }' > payload.json + + curl -X POST -H "Content-Type: application/json" \ + -d @payload.json \ + $DISCORD_WEBHOOK + diff --git a/outils/outil_github.md b/outils/outil_github.md index 7857e73..1fcbd25 100644 --- a/outils/outil_github.md +++ b/outils/outil_github.md @@ -21,7 +21,46 @@ Il permet de : - Configurer les fichiers de communautĂ© : comme le CODE_OF_CONDUCT.md, CONTRIBUTING.md, ou FUNDING.yml, pour structurer l'engagement communautaire autour du projet. - Ajouter des Webhooks : bien que les webhooks ne soient pas dĂ©finis directement dans .github, ce dossier peut contenir des scripts ou des workflows (via GitHub Actions) qui envoient des notifications vers des services comme Discord, Slack ou autres via des requĂȘtes HTTP. Par exemple, on peut dĂ©clencher une notification sur Discord Ă  chaque nouvelle PR ou issue ouverte, en utilisant un webhook Discord dans une GitHub Action. -THP met Ă  disposition son dossier [`.github`](https://github.com/TheHackingProject/.github), utilisĂ© dans la plupart de ses repositories. +--- + +### 🔐 Gestion des **Secrets** GitHub + +Pour que certains **workflows GitHub Actions** fonctionnent correctement (par exemple pour envoyer des messages sur Discord, dĂ©ployer une app, ou accĂ©der Ă  une API externe), il est souvent nĂ©cessaire de **dĂ©finir des variables secrĂštes** appelĂ©es **secrets**. + +#### ➕ Ajouter un secret dans un **repository individuel** + +1. Va dans l’onglet **"Settings"** du repository concernĂ©. +2. Clique sur **"Secrets and variables" > "Actions"**. +3. Clique sur **"New repository secret"**. +4. Renseigne le nom (ex: `DISCORD_WEBHOOK_URL`) et la valeur (le token ou l'URL) puis valide. + +Ce secret ne sera utilisable que dans **ce repository**. + +#### 🏱 Ajouter un secret **dans une organisation** (commun Ă  tous les repos) + +Si tes dĂ©pĂŽts font partie d'une **organisation GitHub** (comme c’est le cas pour THP), tu peux centraliser les secrets pour tous les repos : + +1. Va dans les **Settings de l’organisation**. +2. Dans le menu latĂ©ral, clique sur **"Secrets and variables" > "Actions"**. +3. Clique sur **"New organization secret"**. +4. Choisis Ă  quels dĂ©pĂŽts ce secret est accessible (tous ou sĂ©lection). +5. Renseigne nom et valeur du secret, comme pour un repo classique. + +Cela permet d’éviter de rĂ©pĂ©ter les mĂȘmes secrets dans chaque dĂ©pĂŽt. + +--- + +### 📁 DĂ©ployer le dossier `.github` dans d’autres dĂ©pĂŽts + +MĂȘme si THP met Ă  disposition un dossier `.github` centralisĂ© dans [ce dĂ©pĂŽt](https://github.com/TheHackingProject/.github), il peut ĂȘtre nĂ©cessaire de le **copier dans certains repositories spĂ©cifiques** si : + +- Tu veux **surcharger** ou personnaliser certains comportements uniquement pour ce repo. +- Tu veux **ajouter des workflows spĂ©cifiques** dans `.github/workflows` propres Ă  ce projet. +- Tu veux **tester un nouveau fonctionnement sans impacter les autres dĂ©pĂŽts**. + +Dans ce cas, tu peux crĂ©er un dossier `.github/` Ă  la racine du repo concernĂ©, et y ajouter uniquement les fichiers nĂ©cessaires (workflow, template, etc.). GitHub utilisera en prioritĂ© le `.github` local au repo plutĂŽt que celui de l’organisation. + +--- ## le README originel