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
-
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
-
Installez MinIO.
docker pull minio/minio
Pour plus d’informations, consultez « MinIO Quickstart Guide » (guide de démarrage rapide MinIO officiel).
-
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
-
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
-
Installez le client MinIO.
docker pull minio/mc
-
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 ».