Erstellen eines Images für virtuelle Azure Operator Nexus-Computer
In diesem Artikel erfahren Sie, wie Sie ein Containerimage erstellen, das zum Erstellen eines virtuellen Computers in Operator Nexus verwendet werden kann. Insbesondere erfahren Sie, wie Sie dem Containerimage einen virtuellen Datenträger hinzufügen. Nachdem das Containerimage erstellt und an eine Azure-Containerregistrierung übertragen wurde, kann es verwendet werden, um einen virtuellen Computer in Operator Nexus zu erstellen.
Voraussetzungen
Bevor Sie mit dem Erstellen eines VM-Images (Virtual Machine) beginnen, stellen Sie sicher, dass Die folgenden Voraussetzungen erfüllt sind:
Installieren Sie die aktuelle Version der notwendigen Azure CLI-Erweiterung.
Für diesen Artikel ist mindestens Version 2.49.0 der Azure CLI erforderlich. Bei Verwendung von Azure Cloud Shell ist die aktuelle Version bereits installiert.
Azure Container Registry (ACR): Richten Sie eine funktionierende Azure-Containerregistrierung ein, um Ihre Containerimages zu speichern und zu verwalten. ACR bietet eine sichere und private Registrierung zum Speichern von Docker-Images, die in Ihrem VM-Imageerstellungsprozess verwendet werden. Sie können ein ACR erstellen, indem Sie die offizielle Dokumentation in der Dokumentation zur Azure Container Registry befolgen.
Docker: Installieren Sie Docker auf Ihrem lokalen Computer. Docker ist eine Plattform, mit der Sie Anwendungen als einfache Container erstellen, verpacken und verteilen können. Sie verwenden Docker, um Ihr VM-Image zu erstellen und zu verpacken. Sie können Docker von der offiziellen Website von Docker herunterladen.
Hinweis
Sie können den az login Befehl verwenden, um sich bei Azure zu authentifizieren, und das Skript führt automatisch die ACR-Anmeldung mithilfe des bereitgestellten ACR-Namens und der Abonnement-ID aus. Wenn Sie die Azure CLI nicht auf Ihrem Computer installiert haben, können Sie stattdessen Ihren Benutzernamen und Ihr Kennwort für die ACR-Anmeldung angeben.
Stellen Sie sicher, dass Sie eine betriebsfähige Azure Container Registry (ACR) und Docker auf Ihrem Computer installiert haben, bevor Sie mit der Erstellung eines VM-Images fortfahren. Machen Sie sich mit der Verwendung und Funktionalität von ACR und Docker vertraut, da sie für die Verwaltung Ihrer Containerimages und das Erstellen des VM-Images unerlässlich sind.
Imageanforderungen für virtuelle Computer
Stellen Sie sicher, dass sich ihr VNF-Image (Virtual Network Function) im qcow2-Format befindet, das mit cloud-init gestartet werden kann.
Sie müssen das Startladeprogramm, den Kernel und das Init-System in Ihrem Image konfigurieren, um eine textbasierte serielle Konsole zu aktivieren. Diese Konfiguration ist erforderlich, um die Konsolenunterstützung für Ihren virtuellen Computer (VM) zu aktivieren. Stellen Sie sicher, dass die Einstellungen für den seriellen Anschluss auf Ihrem System und Terminal übereinstimmen, um eine ordnungsgemäße Kommunikation herzustellen.
Sie müssen sicherstellen, dass Ihr VM-Image Cloud-init Version 2 unterstützt, wodurch erweiterte Konfigurationsoptionen während des VM-Initialisierungsprozesses aktiviert werden.
Sie müssen sicherstellen, dass Ihr VM-Image cloudinit mit der
nocloudDatenquelle enthält.nocloudDie Datenquelle ermöglicht die anfängliche Konfiguration und Anpassung während der VM-Bereitstellung.Datenträger müssen in das
/diskVerzeichnis innerhalb des Containers platziert werden.Raw- und qcow2-Formate werden unterstützt. Qcow2 wird empfohlen, um die Größe des Containerimages zu verringern.
Containerdatenträger sollten auf dem
scratchImage basieren, bei dem es sich um ein leeres Basisimage handelt, das keine Anderen Dateien oder Verzeichnisse als das Image selbst enthält. Die Verwendungscratchals Basisimage stellt sicher, dass das Containerimage so klein wie möglich ist und nur die erforderlichen Dateien für den VNF enthält.
Schritte zum Erstellen eines Images für den virtuellen Operator Nexus-Computer
Sie können mithilfe des bereitgestellten Skripts ein Bild für Ihre VNF erstellen. Es generiert eine Dockerfile-Datei, die die VNF-Datenträgerimagedatei in das Verzeichnis des /disk Containers kopiert.
Hinweis
Das folgende Skript wird als Beispiel bereitgestellt. Wenn Es Ihnen lieber ist, können Sie das Containerimage manuell erstellen und übertragen, anstatt dem Skript zu folgen.
Die folgenden Umgebungsvariablen werden verwendet, um das Skript zum Erstellen eines VM-Images für Ihre VNF zu konfigurieren. Ändern und exportieren Sie diese Variablen mit Ihren eigenen Werten, bevor Sie das Skript ausführen:
# 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=""
Um ein VM-Image für Ihre Virtuelle Netzwerkfunktion (Virtual Network Function, VNF) zu erstellen, speichern Sie das bereitgestellte Skript als create-container-disk.sh, legen Sie die erforderlichen Umgebungsvariablen fest, und führen Sie das Skript aus.
#!/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!"
Nach dem Ausführen des Skripts verfügen Sie über ein VM-Image, das auf Ihre Virtuelle Netzwerkfunktion (Virtual Network Function, VNF) zugeschnitten ist. Sie können dieses Image verwenden, um Ihre VNF bereitzustellen.
Beispielverwendung
Legen Sie die erforderlichen Umgebungsvariablen fest.
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"Speichern Sie das bereitgestellte Skript als
create-container-disk.shausführbare Datei.chmod +x create-container-disk.shFühren Sie das Skript aus.
$ ./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!
Nächste Schritte
In der Schnellstartanleitung finden Sie Informationen zum Bereitstellen einer VNF mithilfe des von Ihnen erstellten Images.