Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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
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.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
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
- Use ORAS para cargar el artefacto en ACR.
<artifact-name>
debe coincidir con laartifactName
propiedad en el manifiesto del artefacto.<artifact-tag>
debe coincidir con laartifactVersion
propiedad en el manifiesto del artefacto.<artifact-tag>
debe estar en1.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
- Use ORAS para extraer un artefacto del ACR.
oras pull <acr-name>.azurecr.io/<artifact-name>:<artifact-tag>