Partage via

Créer une image pour une machine virtuelle Azure Operator Nexus

  • Article

Dans cet article, vous allez apprendre à créer une image conteneur qui peut être utilisée pour créer une machine virtuelle dans Operator Nexus. Plus précisément, vous allez apprendre à ajouter un disque virtuel à l’image conteneur. Une fois l’image conteneur générée et envoyée (push) à un registre de conteneurs Azure, elle peut être utilisée pour créer une machine virtuelle dans Operator Nexus.

Prérequis

Avant de commencer à créer une image de machine virtuelle, vérifiez que vous disposez des conditions préalables suivantes :

  • Installez la dernière version des extensions Azure CLI nécessaires.

  • Cet article nécessite la version 2.49.0 ou ultérieure d’Azure CLI. Si vous utilisez Azure Cloud Shell, la version la plus récente est déjà installée.

  • Azure Container Registry (ACR) : configurez un Registre de conteneurs Azure opérationnel pour stocker et gérer vos images conteneur. ACR fournit un registre sécurisé et privé pour stocker des images Docker utilisées dans votre processus de création d’images de machine virtuelle. Vous pouvez créer un ACR en suivant la documentation officielle d’Azure Container Registry .

  • Docker : installez Docker sur votre ordinateur local. Docker est une plateforme qui vous permet de générer, de empaqueter et de distribuer des applications en tant que conteneurs légers. Vous utilisez Docker pour générer et empaqueter votre image de machine virtuelle. Vous pouvez télécharger Docker à partir du site web officiel de Docker.

Remarque

Vous pouvez utiliser la az login commande pour vous authentifier auprès d’Azure et le script effectue automatiquement la connexion ACR à l’aide du nom ACR et de l’ID d’abonnement fournis. Si azure CLI n’est pas installé sur votre machine, vous pouvez fournir votre nom d’utilisateur et votre mot de passe pour la connexion ACR à la place.

Vérifiez que vous disposez d’un Azure Container Registry (ACR) opérationnel et de Docker installé sur votre machine avant de poursuivre la création d’une image de machine virtuelle. Familiarisez-vous avec l’utilisation et les fonctionnalités d’ACR et Docker, car elles sont essentielles pour gérer vos images conteneur et générer l’image de machine virtuelle.

Configuration requise pour l’image de machine virtuelle

  • Vérifiez que votre image de fonction de Réseau virtuel (VNF) est au format qcow2 qui peut démarrer avec cloud-init.

  • Vous devez configurer le chargeur de démarrage, le noyau et le système init dans votre image pour activer une console série basée sur du texte. Cette configuration est nécessaire pour activer la prise en charge de la console pour votre machine virtuelle. Assurez-vous que les paramètres de port série sur votre système et votre terminal correspondent pour établir une communication appropriée.

  • Vous devez vous assurer que votre image de machine virtuelle prend en charge cloud-init version 2, en activant les options de configuration avancées pendant le processus d’initialisation de la machine virtuelle.

  • Vous devez vous assurer que votre image de machine virtuelle inclut cloud-init avec la source de nocloud données. nocloud la source de données permet la configuration et la personnalisation initiales pendant l’approvisionnement de machines virtuelles.

  • Les disques doivent être placés dans le répertoire à l’intérieur /disk du conteneur.

  • Les formats Raw et qcow2 sont pris en charge. Qcow2 est recommandé pour réduire la taille de l’image conteneur.

  • Les disques de conteneur doivent être basés sur l’image scratch , qui est une image de base vide qui ne contient aucun fichier ou répertoire autre que l’image elle-même. L’utilisation scratch comme image de base garantit que l’image conteneur est aussi petite que possible et inclut uniquement les fichiers nécessaires pour le VNF.

Étapes de création d’image pour la machine virtuelle Opérateur Nexus

Vous pouvez créer une image pour votre VNF à l’aide du script fourni. Il génère un fichier Dockerfile qui copie le fichier image de disque VNF dans le répertoire du /disk conteneur.

Remarque

Le script suivant est fourni comme exemple. Si vous préférez, vous pouvez créer et envoyer (push) l’image conteneur manuellement au lieu de suivre le script.

Les variables d’environnement suivantes permettent de configurer le script pour la création d’une image de machine virtuelle pour votre VNF. Modifiez et exportez ces variables avec vos propres valeurs avant d’exécuter le script :


# Azure subscription ID (provide if not using username-password)
export SUBSCRIPTION="your_subscription_id"

# (Mandatory) Azure Container Registry name
export ACR_NAME="your_acr_name"

# (Mandatory) Name of the container image
export CONTAINER_IMAGE_NAME="your_container_image_name"

# (Mandatory) Tag for the container image
export CONTAINER_IMAGE_TAG="your_container_image_tag"

# (Mandatory) VNF image (URL, local file, or full local path)
export VNF_IMAGE="your_vnf_image"

# (Optional) ACR URL (leave empty to derive from ACR_NAME)
export ACR_URL=""

# (Optional) ACR login username (provide if not using subscription)
export USERNAME=""

# (Optional) ACR login password (provide if not using subscription)
export PASSWORD=""

Pour créer une image de machine virtuelle pour votre fonction Réseau virtuel (VNF), enregistrez le script fourni sous create-container-disk.sh, définissez les variables d’environnement requises et exécutez le script.

#!/bin/bash

# Define the required environment variables
required_vars=(
    "ACR_NAME"                  # Azure Container Registry name
    "CONTAINER_IMAGE_NAME"      # Name of the container image
    "CONTAINER_IMAGE_TAG"       # Tag for the container image
    "VNF_IMAGE"                 # VNF image (URL or file path)
)

# Verify if required environment variables are set
for var in "${required_vars[@]}"; do
    if [ -z "${!var}" ]; then
        echo "Error: $var environment variable is not set."
        exit 1
    fi
done

# Check if either SUBSCRIPTION or USERNAME with PASSWORD is provided
if [ -z "$SUBSCRIPTION" ] && [ -z "$USERNAME" ] && [ -z "$PASSWORD" ]; then
    echo "Error: Either provide SUBSCRIPTION or USERNAME with PASSWORD."
    exit 1
fi

# Set default value for DOCKERFILE_NAME if not set
if [ -z "$DOCKERFILE_NAME" ]; then
    DOCKERFILE_NAME="nexus-vm-img-dockerfile"
fi

# Check if ACR_URL is already set by the user
if [ -z "$ACR_URL" ]; then
    # Derive the ACR URL from the ACR_NAME
    ACR_URL="$ACR_NAME.azurecr.io"
fi

# Initialize variables for downloaded/copied files
downloaded_files=()

# Function to clean up downloaded files
cleanup() {
    for file in "${downloaded_files[@]}"; do
        if [ -f "$file" ]; then
            rm "$file"
        fi
    done
}

# Register the cleanup function to be called on exit
trap cleanup EXIT

# Check if the VNF image is a URL or a local file
if [[ "$VNF_IMAGE" == http* ]]; then
    # Use curl to download the file
    filename=$(basename "$VNF_IMAGE")
    # Download the VNF image file and save the output to a file
    curl -f -Lo "$filename" "$VNF_IMAGE"
    if [ $? -ne 0 ]; then
        echo "Error: Failed to download file."
        exit 1
    fi
    # Add the downloaded file to the list for cleanup
    downloaded_files+=("$filename")
elif [[ "$VNF_IMAGE" == /* ]]; then
    # Use the provided full local path
    filename=$(basename "$VNF_IMAGE")
    # Copy the VNF image file to the current directory for cleanup
    cp "$VNF_IMAGE" "./$filename"
    # Add the copied file to the list for cleanup
    downloaded_files+=("$filename")
else
    # Assume it's a local file in the current directory
    filename="$VNF_IMAGE"
fi

# Check if the file exists
if [ ! -f "$filename" ]; then
    echo "Error: File $filename does not exist."
    exit 1
fi

# Create a Dockerfile that copies the VNF image file into the container's /disk directory
# The containerDisk needs to be readable for the user with the UID 107 (qemu).
cat <<EOF > "$DOCKERFILE_NAME"
FROM scratch
ADD --chown=107:107 "$filename" /disk/
EOF

# Build the Docker image and tag it to the Azure Container Registry
docker build -f "$DOCKERFILE_NAME" -t "$CONTAINER_IMAGE_NAME:$CONTAINER_IMAGE_TAG" .

# Log in to Azure Container Registry
if [ -n "$USERNAME" ] && [ -n "$PASSWORD" ]; then
    docker login "$ACR_NAME.azurecr.io" -u "$USERNAME" -p "$PASSWORD"
else
    az acr login --name "$ACR_NAME" --subscription "$SUBSCRIPTION"
fi

docker tag "$CONTAINER_IMAGE_NAME:$CONTAINER_IMAGE_TAG" "$ACR_URL/$CONTAINER_IMAGE_NAME:$CONTAINER_IMAGE_TAG"
docker push "$ACR_URL/$CONTAINER_IMAGE_NAME:$CONTAINER_IMAGE_TAG"

# Remove the downloaded/copied files
cleanup

rm "$DOCKERFILE_NAME"

echo "VNF image $ACR_URL/$CONTAINER_IMAGE_NAME:$CONTAINER_IMAGE_TAG created successfully!"

Après avoir exécuté le script, vous disposez d’une image de machine virtuelle adaptée à votre fonction de Réseau virtuel (VNF). Vous pouvez utiliser cette image pour déployer votre VNF.

Exemple d’utilisation

  1. Définissez les variables d’environnement requises.

    export SUBSCRIPTION=""00000000-0000-0000-0000-000000000000""
export ACR_NAME="myvnfacr"
export CONTAINER_IMAGE_NAME="ubuntu"
export CONTAINER_IMAGE_TAG="20.04"
export VNF_IMAGE="https://cloud-images.ubuntu.com/releases/focal/release/ubuntu-20.04-server-cloudimg-amd64.img"

  2. Enregistrez le script fourni sous create-container-disk.sh et faites-le exécutable.

    chmod +x create-container-disk.sh

  3. Exécutez le script.

    $ ./create-container-disk.sh
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  622M  100  622M    0     0  24.7M      0  0:00:25  0:00:25 --:--:-- 26.5M
[+] Building 36.6s (5/5) FINISHED
 => [internal] load .dockerignore                                                              0.1s
 => => transferring context: 2B                                                                0.0s
 => [internal] load build definition from nexus-vm-img-dockerfile                              0.1s
 => => transferring dockerfile: 137B                                                           0.0s
 => [internal] load build context                                                              36.4s
 => => transferring context: 652.33MB                                                          36.3s
 => CACHED [1/1] ADD --chown=107:107 ubuntu-20.04-server-cloudimg-amd64.img /disk/             0.0s
 => exporting to image                                                                         0.0s
 => => exporting layers                                                                        0.0s
 => => writing image sha256:5b5f531c132cdbba202136b5ec41c9bfe9d91beeb5acee617c1ef902df4ca772   0.0s
 => => naming to docker.io/library/ubuntu:20.04                                                0.0s
Login Succeeded
The push refers to repository [myvnfacr.azurecr.io/ubuntu]
b86efae7de58: Layer already exists
20.04: digest: sha256:d514547ee28d9ed252167d0943d4e711547fda95161a3728c44a275f5d9669a8 size: 529
VNF image myvnfacr.azurecr.io/ubuntu:20.04 created successfully!

Étapes suivantes

Reportez-vous au guide de démarrage rapide pour déployer un VNF à l’aide de l’image que vous avez créée.