Inserción y extracción de imágenes y otros artefactos hacia o desde un almacén de artefactos respaldado por Azure Container Registry (ACR)

El recurso de almacén de artefactos de Azure Operator Service Manager (AOSM) administra los artefactos necesarios para implementar funciones de red (NFs). Estos artefactos incluyen imágenes de función de red en contenedores (CNF), imágenes de funciones de red virtualizadas (VNF), plantillas de Azure Resource Manager (ARM) y paquetes de Helm. Hay dos tipos de almacén de artefactos:

• Azure Container Registry (ACR): se usa para proporcionar almacenamiento para CNF en todas las plataformas y VNF en Azure Operator Nexus
• Cuenta de almacenamiento : se usa para proporcionar almacenamiento para las VNF en Azure Core

La extensión AOSM de la CLI de Azure proporciona un comando para insertar todos los artefactos necesarios por un CNF o VNF en Azure Operator Nexus. Hay algunos casos de uso en los que puede ser necesario transferir artefactos a un almacén de artefactos de manera individual o extraerlos de este.

• Es posible que haya proporcionado la imagen de contenedor incorrecta y tenga que insertar una sola imagen de reemplazo.
• Es posible que tenga que publicar una nueva versión de un único contenedor para corregir un problema.
• Es posible que tenga que editar la plantilla de NF ARM como parte de un ciclo de depuración.
• Es posible que tenga que editar paquetes de Helm o una plantilla de ARM de máquina virtual como parte de un ciclo de depuración

En este artículo de procedimientos, se describe cómo insertar artefactos en un almacén de artefactos respaldado por ACR existente y extraerlos mediante el recurso de manifiesto de artefacto de AOSM y la herramienta de línea de comandos ORAS. Consulte este Instrucciones para obtener el artículo equivalente sobre almacenes de artefactos respaldados por la cuenta de almacenamiento.

Prerrequisitos

• Habilitación de AOSM en la suscripción de Azure
• Instale la CLI de Azure.
• Implementación de un recurso del Almacén de artefactos de tipo Azure Container Registry
• Implemente un recurso de manifiesto de artefacto que contenga una entrada para el artefacto que desea instalar. En este ejemplo se muestra la definición de Bicep del manifiesto de artefacto para una imagen ficticia de contenedor CNF de Contoso

resource acrArtifactManifest 'Microsoft.Hybridnetwork/publishers/artifactStores/artifactManifests@2023-09-01' = {
  parent: 'contoso-cnf-store'
  name: 'contoso-cnf-manifest'
  location: 'eastus'
  properties: {
    artifacts: [
      {
        artifactName: 'contoso-cnf-container'
        artifactType: 'OCIArtifact'
        artifactVersion: '0.1.0'
      }
    ]
  }
}

• (Si va a descargar un artefacto) El artefacto ya está disponible en el recurso del almacén de artefactos de AOSM.
• (Si va a cargar un artefacto) El artefacto está disponible en el entorno desde el que se ejecutan los comandos de este artículo.
• Instalación de la CLI de ORAS
• Necesita el rol Colaborador en el grupo de recursos que contiene el almacén de artefactos

Inicia sesión en un almacén de artefactos respaldado por ACR

1. Obtención de permisos con ámbito de repositorio del recurso de manifiesto de artefacto

   az rest --method POST --url 'https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.HybridNetwork/publishers/<publisher>/artifactStores/<artifact-store-name>/artifactManifests/<artifact-manifest-name>/listCredential?api-version=2023-09-01'
   

   Este comando devuelve el nombre de usuario y la contraseña que usará para iniciar sesión en el ACR que respalda el almacén de artefactos. La contraseña está en el token campo .

   {
     "acrServerUrl": "https://<acr-name>.azurecr.io",
     "acrToken": "<token>",
     "credentialType": "AzureContainerRegistryScopedToken",
     "expiry": "2024-03-27T10:25:03.9217887+00:00",
     "repositories": [
       "<artifact-name>"
     ],
     "username": "<artifact-manifest-name>"
   }
   

   Importante

   El recurso del manifiesto de artefacto concede permisos estrechamente de ámbito para las operaciones de inserción y extracción. Debe usar un manifiesto de artefacto que contenga una entrada para el artefacto que desea insertar o extraer. artifactName debe coincidir con el nombre del artefacto en el repositorio. artifactVersion debe coincidir con la etiqueta de artefacto.

2. Busque el nombre del ACR que respalda el recurso del almacén de artefactos para ello, abra el almacén de artefactos y copie el campo Backing storage

   

3. Inicie sesión en ACR mediante la CLI de ORAS

oras login <acr-name>.azurecr.io --username <artifact-manifest-name> --password <token>

Inserción de un artefacto en un almacén de artefactos respaldado por ACR

1. Use ORAS para cargar el artefacto en ACR. <artifact-name> debe coincidir con la artifactName propiedad en el manifiesto del artefacto. <artifact-tag> debe coincidir con la artifactVersion propiedad en el manifiesto del artefacto. <artifact-tag> debe estar en 1.0.0 formato

oras push <acr-name>.azurecr.io/<artifact-name>:<artifact-tag> </path/to/artifact>

Extracción de un artefacto de un almacén de artefactos respaldado por ACR

1. Use ORAS para extraer un artefacto del ACR.

oras pull <acr-name>.azurecr.io/<artifact-name>:<artifact-tag>

Pasos siguientes

• Consulte ORAS push para obtener instrucciones de uso más detalladas para el oras push comando.
• Consulte ORAS pull para obtener instrucciones de uso más detalladas para el comando oras pull.