Skip to main content

Cette version de GitHub Enterprise Server n'est plus disponible depuis le 2024-07-09. Aucune publication de correctifs n’est effectuée, même pour les problèmes de sécurité critiques. Pour de meilleures performances, une sécurité améliorée et de nouvelles fonctionnalités, effectuez une mise à niveau vers la dernière version de GitHub Enterprise. Pour obtenir de l’aide sur la mise à niveau, contactez le support GitHub Enterprise.

Démarrage rapide : Configuration de votre compartiment de stockage MinIO pour GitHub Packages

Configurez votre compartiment de stockage MinIO personnalisé à utiliser avec GitHub Packages.

Platform navigation

Pour pouvoir activer et configurer GitHub Packages sur votre instance GitHub Enterprise Server, vous devez préparer votre solution de stockage de tiers.

MinIO assure le stockage d’objets avec prise en charge de l’API S3 et de GitHub Packages sur votre entreprise.

Ce guide de démarrage rapide vous montre comment configurer MinIO à l’aide de Docker pour une utilisation avec GitHub Packages. Cependant, vous disposez d’autres options pour gérer MinIO, au-delà de Docker. Pour plus d’informations sur MinIO, consultez la documentation officielle de MinIO.

1. Choisir un mode MinIO répondant à vos besoins

Mode MinIOOptimisé pourInfrastructure de stockage nécessaire
MinIO autonome (sur un seul hôte)Configuration rapideNon applicable
MinIO clusterisé (ou MinIO distribué)Sécurité des donnéesServeurs de stockage exécutés dans un cluster

Pour plus d’informations sur vos options, consultez la documentation officielle de MinIO.

2. Installer et exécuter MinIO et se connecter à MinIO

  1. Configurez vos variables d’environnement préférées pour MinIO.

    MINIO_DIR est utilisé pour ces exemples :

    export MINIO_DIR=$(pwd)/minio
    mkdir -p $MINIO_DIR
    
  2. Installez MinIO.

    docker pull minio/minio
    

    Pour plus d’informations, consultez « MinIO Quickstart Guide » (guide de démarrage rapide MinIO officiel).

  3. Connectez-vous à MinIO à l’aide de votre clé d’accès et de votre secret MinIO.

    $ export MINIO_ACCESS_KEY=$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1)
    # this one is actually a secret, so careful
    $ export MINIO_SECRET_KEY=$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1)
    
    $ export MINIO_ACCESS_KEY=$(cat /dev/urandom | LC_CTYPE=C tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1)
    # this one is actually a secret, so careful
    $ export MINIO_SECRET_KEY=$(cat /dev/urandom | LC_CTYPE=C tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1)
    

    Vous pouvez accéder à vos clés MinIO à l’aide des variables d’environnement :

    echo $MINIO_ACCESS_KEY
    echo $MINIO_SECRET_KEY
    
  4. Exécutez MinIO dans le mode choisi.

    • Exécutez MinIO à l’aide de Docker sur un seul hôte :

      $ docker run -p 9000:9000 \
              -v $MINIO_DIR:/data \
              -e "MINIO_ACCESS_KEY=$MINIO_ACCESS_KEY" \
              -e "MINIO_SECRET_KEY=$MINIO_SECRET_KEY" \
              minio/minio server /data
      

      Pour plus d’informations, consultez « MinIO Docker Quickstart guide » (guide de démarrage rapide pour l’utilisation de Docker avec MinIO).

    • Exécutez MinIO en utilisant Docker comme cluster. Ce déploiement de MinIO utilise plusieurs hôtes et le codage d’effacement de MinIO pour une protection des données optimale. Pour exécuter MinIO en mode cluster, consultez « Démarrage rapide MinIO distribué ».

3. Créer votre compartiment MinIO pour GitHub Packages

  1. Installez le client MinIO.

    docker pull minio/mc
    
  2. Créez un compartiment avec une URL hôte à laquelle GitHub Enterprise Server peut accéder.

    • Exemple de déploiements locaux :

      export MC_HOST_minio="http://${MINIO_ACCESS_KEY}:${MINIO_SECRET_KEY} @localhost:9000"
      docker run minio/mc BUCKET-NAME
      

      Cet exemple peut être utilisé pour MinIO autonome.

    • Exemple de déploiements clusterisés :

      export MC_HOST_minio="http://${MINIO_ACCESS_KEY}:${MINIO_SECRET_KEY} @minioclustername.example.com:9000"
      docker run minio/mc mb packages
      

Étapes suivantes

Pour terminer la configuration du stockage pour GitHub Packages, vous devez copier l’URL de stockage MinIO :

echo "http://${MINIO_ACCESS_KEY}:${MINIO_SECRET_KEY}@minioclustername.example.com:9000"

Pour les étapes suivantes, consultez « Activation de GitHub Packages avec MinIO ».