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

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 MinIO	Optimisé pour	Infrastructure de stockage nécessaire
MinIO autonome (sur un seul hôte)	Configuration rapide	Non applicable
MinIO clusterisé (ou MinIO distribué)	Sécurité des données	Serveurs 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 ».