Travailler avec des registres d’images et des référentiels¶
Snowpark Container Services fournit un service de registre d’images conforme à OCIv2 et un référentiel d’appel d’unités de stockage pour stocker les images. Vous pouvez utiliser les commandes Snowflake CLI suivantes pour gérer les registres et référentiels d’images Snowpark Container Services :
Pour plus d’informations sur les référentiels d’images Snowpark Container Services, voir Snowpark Container Services : utilisation d’un registre et d’un référentiel d’images.
Gérer les registres d’images¶
Snowflake CLI vous permet d’effectuer les tâches suivantes avec les référentiels d’images Snowpark Container Services :
Pour les opérations courantes, telles que l’affichage sous forme de liste ou la suppression, Snowflake CLI utilise les commandes snow object décrites dans Gestion des objets Snowflake.
Obtenir des jetons d’environnement pour l’authentificateur du registre¶
Vous pouvez utiliser la commande snow spcs image-registry token pour renvoyer le jeton associé à la connexion spécifiée que vous pouvez utiliser pour vous authentifier auprès du registre.
snow spcs image-registry token --connection mytest
+----------------------------------------------------------------------------------------------------------------------+
| key | value |
|------------+---------------------------------------------------------------------------------------------------------|
| token | **************************************************************************************************** |
| | **************************************************************************************************** |
| expires_in | 3600 |
+----------------------------------------------------------------------------------------------------------------------+
Vous pouvez ensuite utiliser ce jeton pour vous connecter à un conteneur Docker en le faisant passer dans la commande docker login, comme dans l’exemple suivant :
snow spcs image-registry token --format=JSON | docker login <org>-<account>.registry.snowflakecomputing.com -u 0sessiontoken --password-stdin
Se connecter à un registre d’images¶
snow spcs image-registry login vous connecte à un référentiel d’images avec les identifiants de connexion spécifiés pour votre connexion. Avant de vous connecter, vous devez remplir les conditions suivantes :
Docker Desktop doit être installé car la commande utilise docker pour se connecter à Snowflake.
Le rôle actuel doit avoir les privilèges READ pour le référentiel d’images dans le compte pour obtenir l’URL de registre.
Pour vous connecter à un registre d’images avec les identifiants de votre compte, procédez comme suit :
snow spcs image-registry login
Login Succeeded
Récupérer l’URL pour un registre d’images¶
La commande snow spcs image-registry url renvoie une URL pour un référentiel d’images. Le rôle actuel doit avoir les privilèges READ pour le référentiel d’images dans le compte pour obtenir l’URL de registre.
Pour obtenir l’URL d’un référentiel, procédez comme suit :
snow spcs image-registry url
<orgname-acctname>.registry.snowflakecomputing.com
Gérer les référentiels d’images¶
Snowflake CLI vous permet d’effectuer les tâches suivantes avec les référentiels d’images Snowpark Container Services :
Créer et déployer un référentiel d’images à partir d’une définition de projet
Afficher la liste des balises et des images dans un référentiel d’images
Pour les opérations courantes, telles que l’affichage sous forme de liste ou la suppression, Snowflake CLI utilise les commandes snow object décrites dans Gestion des objets Snowflake.
Créer un référentiel d’images¶
La commande snow spcs image-repository create crée un nouveau référentiel d’images dans le schéma actuel.
Pour créer un référentiel d’images, entrez une commande similaire à la suivante :
snow spcs image-repository create tutorial_repository
+-------------------------------------------+
| key | value |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+
Créer et déployer un référentiel d’images à partir d’une définition de projet¶
Vous pouvez déployer un référentiel d’images dans une zone de préparation en créant un fichier de définition de projet snowflake.yml et en exécutant la commande snow spcs image-repository deploy.
Vous trouverez ci-dessous un exemple de fichier de définition de projet snowflake.yml :
definition_version: 2
entities:
my_image_repository:
type: image-repository
identifier: my_image_repository
La table suivante décrit les propriétés d’une définition de projet de pool de calcul.
Propriété |
Définition |
|---|---|
type required, string |
Doit être |
identifier optional, string |
Identificateur Snowflake de l’entité. La valeur peut avoir les formes suivantes :
|
Pour créer et déployer le référentiel d’images, procédez comme suit :
Définissez votre répertoire actuel pour le répertoire contenant le fichier de définition du projet.
Exécutez une commande
snow spcs image-repository deploysimilaire à la suivante :snow spcs image-repository deploy
+---------------------------------------------------------------------+ | key | value | |--------+------------------------------------------------------------| | status | Image Repository MY_IMAGE_REPOSITORY successfully created. | +---------------------------------------------------------------------+
Récupérez l’URL pour un référentiel d’images¶
La commande snow spcs image-repository url permet d’obtenir l’URL pour un référentiel d’images.
Pour obtenir l’URL, entrez une commande similaire à la suivante :
snow spcs image-repository url tutorial_repository
<orgname-acctname>.registry.snowflakecomputing.com/tutorial_db/data_schema/tutorial_repository