GitHub — guide complet

01 Qu'est-ce que GitHub ?

GitHub est la plus grande plateforme de collaboration autour de Git. Fondée en 2008 par Tom Preston-Werner, Chris Wanstrath, P.J. Hyett et Scott Chacon, elle est rachetée par Microsoft en 2018 pour 7,5 milliards de dollars. En 2024, GitHub héberge plus de 420 millions de dépôts et compte plus de 100 millions de développeurs.

Git (créé par Linus Torvalds en 2005) est un système de contrôle de version distribué fonctionnant localement. GitHub ajoute la couche distante : hébergement, collaboration, revue de code, automatisation, sécurité et API.

02 Git — rappel des bases

GitHub est bâti sur Git. Comprendre Git est indispensable.

03 Concepts fondamentaux GitHub

04 Cycle de travail complet

# 1. Cloner le dépôt
git clone https://github.com/org/projet.git
cd projet

# 2. Créer une branche de travail
git checkout -b feature/auth-oauth

# 3. Développer et committer
#    (modifier les fichiers)
git add .
git commit -m "feat: add OAuth2 authentication with GitHub provider"

# 4. Pousser la branche vers GitHub
git push -u origin feature/auth-oauth

# 5. Ouvrir une Pull Request sur GitHub
#    → Revue de code par les pairs
#    → CI automatique (GitHub Actions)
#    → Approbation required
#    → Merge dans main

# 6. Mettre à jour sa branche locale
git checkout main
git pull origin main

05 Interface GitHub — sections détaillées

06 Gestion avancée des branches

Une stratégie de branches solide est essentielle sur les projets d'équipe.

# Configurer la protection de branche via GitHub CLI
gh api repos/{owner}/{repo}/branches/main/protection \
  --method PUT \
  --field required_status_checks='{"strict":true,"contexts":["ci/tests"]}' \
  --field enforce_admins=true \
  --field required_pull_request_reviews='{"required_approving_review_count":1}'

07 Pull Requests — guide complet

Une Pull Request est le cœur de la collaboration GitHub.

Modes de fusion

08 GitHub Actions — CI/CD

GitHub Actions permet de définir des pipelines d'automatisation en YAML dans .github/workflows/.

name: PHP CI / CD Pipeline
on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        php-version: ['8.1', '8.2', '8.3']
    steps:
      - uses: actions/checkout@v4
      - name: Setup PHP ${{ matrix.php-version }}
        uses: shivammathur/setup-php@v2
        with:
          php-version: '${{ matrix.php-version }}'
          extensions: mbstring, pdo, opcache
          coverage: xdebug
      - name: Install dependencies
        run: composer install --prefer-dist --no-progress
      - name: Run PHPUnit
        run: vendor/bin/phpunit --coverage-text

  deploy:
    needs: test
    runs-on: ubuntu-latest
    if: github.ref == 'refs/heads/main'
    steps:
      - uses: actions/checkout@v4
      - name: Deploy to production
        run: ./deploy.sh
        env:
          SERVER_KEY: ${{ secrets.DEPLOY_KEY }}

09 Sécurité sur GitHub

10 Organisations, équipes et droits

GitHub supporte des comptes personnels et des organisations. Une organisation peut gérer des dizaines de dépôts avec des politiques centralisées.

11 Releases, Tags et Packages

# Créer un tag annoté
git tag -a v2.1.0 -m "Release v2.1.0 — ajout OAuth2"
git push origin v2.1.0

# Créer une release via GitHub CLI
gh release create v2.1.0 \
  --title "v2.1.0 — OAuth2 & performance improvements" \
  --notes-file CHANGELOG.md \
  --generate-notes \
  dist/app-linux.tar.gz

Les GitHub Packages permettent d'héberger des packages directement sur GitHub :

12 API REST et GraphQL

# Lister les repos d'une organisation
curl -H "Authorization: token VOTRE_TOKEN" \
  https://api.github.com/orgs/microsoft/repos

# Créer une issue via API REST
curl -X POST \
  -H "Authorization: token VOTRE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"Bug: login redirect","body":"Détails...","labels":["bug"]}' \
  https://api.github.com/repos/owner/repo/issues

GraphQL

# Requête GraphQL pour lister des PR ouvertes
query {
  repository(owner: "owner", name: "repo") {
    pullRequests(first: 10, states: OPEN) {
      nodes {
        title number author { login } createdAt
        reviews(first: 3) {
          nodes { state author { login } }
        }
      }
    }
  }
}

13 GitHub CLI, Desktop & Codespaces

# GitHub CLI — exemples utiles
gh auth login                              # Authentification
gh repo create mon-projet --public         # Créer un repo
gh pr create --title "feat: login" --body "..."  # Ouvrir une PR
gh pr list --state open                    # Lister les PR
gh pr merge 42 --squash                    # Merger la PR #42
gh issue create --title "Bug: crash"        # Créer une issue
gh issue list --label bug                  # Filtrer les issues
gh release create v1.0.0                   # Créer une release
gh run list                                # Lister les Actions runs
gh run watch                               # Surveiller le run en cours

14 GitHub Pages & Documentation

GitHub Pages permet d'héberger gratuitement un site statique depuis un dépôt GitHub :

# Activer GitHub Pages depuis la branche gh-pages
# Settings → Pages → Source: Deploy from branch

# Exemple de workflow pour déployer avec Jekyll ou mkdocs
name: Deploy Docs
on:
  push: { branches: [main] }
jobs:
  deploy:
    permissions: { pages: write, id-token: write }
    environment: { name: github-pages, url: ${{ steps.deploy.outputs.page_url }} }
    steps:
      - uses: actions/checkout@v4
      - uses: actions/configure-pages@v4
      - uses: actions/upload-pages-artifact@v3
        with: { path: ./docs }
      - id: deploy
        uses: actions/deploy-pages@v4

15 Bonnes pratiques Git & GitHub

16 Pièges fréquents

17 Résumé

GitHub est à la fois un hébergeur de code, une plateforme de collaboration et une usine d'automatisation. Son cœur est Git, mais sa valeur réelle vient de l'intégration fluide entre dépôt, revue de code, issues, CI/CD (Actions), sécurité (Dependabot, Secret Scanning), documentation (Pages, Wiki) et API programmable.