Udostępnij za pośrednictwem

Dołączanie zwirtualizowanej funkcji sieci (VNF) do wdrożenia na platformie Azure Operator Nexus do programu Azure Operator Service Manager (AOSM)

W tym przewodniku wydawcy funkcji sieciowych i projektanci usług dowiedzą się, jak za pomocą rozszerzenia Azure CLI AOSM wprowadzić zwirtualizowaną funkcję sieciową do systemu AOSM. Ten VNF można następnie wdrożyć na platformie Azure Operator Nexus. Dołączanie jest procesem wieloetapowym. Po spełnieniu wymagań wstępnych, użyjesz rozszerzenia Azure CLI AOSM, aby:

  1. Generowanie plików Bicep, które definiują grupę i wersję definicji funkcji sieciowych (NFD).
  2. Opublikuj NFD i prześlij obraz VNF do repository artefaktów (Azure Container Registry zarządzanego przez AOSM).
  3. Dodaj opublikowany NFD do plików Bicep, które definiują Grupę Projektową Usługi Sieciowej i Wersję (NSD).
  4. Opublikuj NSD.

Wymagania wstępne

Uwaga / Notatka

Zdecydowanie zaleca się przetestowanie, czy wdrożenie maszyny wirtualnej zakończy się pomyślnie w instancji Azure Operator Nexus przed włączeniem VNF do AOSM.

Obrazy maszyn wirtualnych Azure Operator Nexus i szablony Azure Resource Manager (ARM)

  • Stworzyłeś obraz dla maszyny wirtualnej Azure Operator Nexus. Ten obraz musi być dostępny w usłudze ACR.

  • Utworzono szablon usługi ARM, który wdraża maszynę wirtualną Platformy Azure Operator Nexus.

  • Szablon ARM maszyny wirtualnej (zarówno dla platformy AzureCore, jak i Azure Operator Nexus) może wdrażać tylko zasoby ARM od następujących dostawców zasobów.

    • Microsoft.Compute
    • Microsoft.Network
    • Microsoft.NetworkCloud
    • Microsoft.Storage
    • Microsoft.NetworkFabric
    • Microsoft.Authorization
    • Microsoft.ManagedIdentity

  • Szablon ARM VNF powinien wdrożyć jedną maszynę wirtualną. Wiele maszyn wirtualnych (VM) można wdrożyć, uwzględniając wiele instancji NFDV w NSDV.

Konfigurowanie uprawnień

  • Musisz mieć rolę Współautora w swojej subskrypcji, aby móc utworzyć nową grupę zasobów lub mieć dostęp do istniejącej grupy zasobów, w której masz rolę Współautora.
  • Wymagane są Reader/AcrPull przypisania ról w źródłowym rekordzie ACR zawierającym obrazy.
  • Wymagane są Contributor przypisania ról i AcrPush w subskrypcji, które będą zawierać zarządzany magazyn artefaktów usługi AOSM. Te uprawnienia umożliwiają rozszerzeniu AOSM interfejsu wiersza polecenia platformy Azure wykonywanie bezpośredniej kopii usługi ACR-to-ACR. Kopiowanie bezpośrednie to najszybsza metoda przesyłania obrazów z jednego rekordu ACR do innego.
    • Polityka Twojej firmy może uniemożliwić Ci posiadanie uprawnień związanych z subskrypcją. Parametr --no-subscription-permissions, dostępny w poleceniach az aosm nfd publish i az aosm nsd publish, używa ściśle ograniczonych uprawnień pochodzących z usługi AOSM, aby koordynować dwuetapową kopię na maszynę lokalną i z niej. Ta kopia dwuetapowa jest wolniejsza, ale nie wymaga uprawnień w zakresie subskrypcji.

Pobieranie i instalowanie interfejsu wiersza polecenia platformy Azure

Aby zainstalować interfejs wiersza polecenia platformy Azure lokalnie, zobacz Jak zainstalować interfejs wiersza polecenia platformy Azure.

Aby zalogować się do interfejsu wiersza polecenia Azure, użyj polecenia az login i wykonaj monity wyświetlane w terminalu, aby zakończyć proces uwierzytelniania. Aby uzyskać więcej opcji logowania, zobacz Logowanie się przy użyciu interfejsu wiersza polecenia platformy Azure.

Uwaga / Notatka

Jeśli korzystasz z systemu Windows lub macOS, rozważ uruchomienie Azure CLI w kontenerze Docker. Aby uzyskać więcej informacji, zobacz Jak uruchomić Azure CLI w kontenerze Docker. Możesz również użyć środowiska powłoki Bash w usłudze Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Uruchamianie usługi Cloud Shell w celu korzystania ze środowiska powłoki Bash w usłudze Azure Cloud Shell.

Helm i silnik Docker

Instalowanie rozszerzenia interfejsu wiersza polecenia programu AOSM

Rozszerzenie AOSM dla Azure CLI wymaga wersji 2.54.0 lub nowszej Azure CLI.

  1. Uruchom polecenie az version , aby wyświetlić zainstalowaną wersję i biblioteki zależne.
  2. Uruchom polecenie az upgrade , aby uaktualnić do bieżącej wersji interfejsu wiersza polecenia platformy Azure.

Zainstaluj rozszerzenie interfejsu wiersza polecenia programu AOSM przy użyciu tego polecenia:

az extension add --name aosm

Tworzenie grupy i wersji definicji funkcji sieci

Ta sekcja tworzy folder w katalogu roboczym o nazwie vnf-cli-output z plikami Bicep zasobów AOSM, które definiują grupę definicji funkcji sieci oraz wersję, a także magazyn artefaktów. Te zasoby zostaną ostatecznie uwzględnione w projekcie usługi sieciowej

  1. Wygeneruj plik wejściowy rozszerzenia AOSM dla Azure CLI dla VNF.

    az aosm nfd generate-config --definition-type vnf-nexus --output-file <filename.jsonc>

  2. Otwórz plik wejściowy wygenerowany w poprzednim kroku i użyj wbudowanych komentarzy, aby wprowadzić wymagane wartości. W tym przykładzie przedstawiono plik wejściowy rozszerzenia AOSM Az CLI dla fikcyjnego VNF firmy Contoso, który działa na platformie Azure Operator Nexus.

    Uwaga / Notatka

    Rozszerzenie AOSM interfejsu wiersza polecenia platformy Azure domyślnie udostępnia tylko wymagane parametry bez wartości domyślnych w tym wejściowym szablonie ARM. Można ustawić expose_all_parameters na true w celu uwidocznienia wszystkich parametrów szablonów ARM w wersji NFDV i schemacie CGS. Aby uzyskać bardziej szczegółowe informacje, zobacz Parametr uwidaczniany przy użyciu rozszerzenia interfejsu wiersza polecenia AOSM .

    {
    // Azure location to use when creating resources e.g uksouth
    "location": "eastus",
    // Name of the Publisher resource you want your definition published to.
    // Will be created if it does not exist.
    "publisher_name": "contoso",
    // Resource group for the Publisher resource.
    // Will be created if it does not exist.
    "publisher_resource_group_name": "contoso-vnf",
    // Name of the ACR Artifact Store resource.
    // Will be created if it does not exist.
    "acr_artifact_store_name": "contoso-vnf-artifact-store",
    // Name of the network function.
    "nf_name": "contoso-vnf",
    // Version of the network function definition in 1.1.1 format (three integers separated by dots).
    "version": "1.0.0",
    // If set to true, all NFD configuration parameters are made available to the designer, including optional parameters and those with defaults.
    // If not set or set to false, only required parameters without defaults will be exposed.
    "expose_all_parameters": false,
    // ARM template configuration. The ARM templates given here would deploy a VM if run. They will be used to generate the VNF.
    "arm_templates": [
        {
            // Name of the artifact. Used as internal reference only.
            "artifact_name": "contoso-vnf",
            // Version of the artifact in 1.1.1 format (three integers separated by dots).
            "version": "1.0.0",
            // File path (absolute or relative to this configuration file) of the artifact you wish to upload from your local disk.
            // Use Linux slash (/) file separator even if running on Windows.
            "file_path": "/home/contoso-vnf/contoso-vnf-arm-template.json"
        }
    ],
    // List of images to be pulled from the acr registry.
    // You must provide the source acr registry, the image name and the version.
    // For example: 'sourceacr.azurecr.io/imagename:imageversion'.
    "images": ["contoso-vnf.azurecr.io/contosovnf:1.0.0"]
}```

  3. Wykonaj następujące polecenie, aby skompilować grupę definicji funkcji sieciowych i wersję.

az aosm nfd build --definition-type vnf-nexus --config-file <filename.jsonc>

Opublikuj Grupę Definicji Funkcji Sieciowej i Wersję

W tym kroku są tworzone zasoby AOSM, które definiują definicję funkcji sieciowej i magazyn artefaktów, które będą używane do przechowywania obrazów maszyn wirtualnych funkcji sieciowej. Przekazuje również obrazy do magazynu artefaktów, kopiując je bezpośrednio ze źródłowego rekordu ACR lub, jeśli nie masz zakresu Contributor subskrypcji i AcrPush ról, przełączając obrazy platformy Docker lokalnie i przekazując je do magazynu artefaktów przy użyciu ściśle ograniczonych poświadczeń wygenerowanych z usługi AOSM.

  1. Wykonaj następujące polecenie, aby opublikować grupę definicji funkcji sieciowych i wersję. Jeśli nie masz zakresu subskrypcji Contributor i ról AcrPush, uwzględnij --no-subscription-permissions w poleceniu.
az aosm nfd publish --build-output-folder vnf-cli-output --definition-type vnf

W razie potrzeby możesz przejrzeć strukturę folderów i plików oraz wprowadzić modyfikacje.

Tworzenie grupy projektowej usługi sieciowej oraz jej wersji

Ta sekcja tworzy folder w katalogu roboczym o nazwie nsd-cli-output. Ten folder zawiera pliki Bicep zasobów AOSM, które definiują grupę projektową i wersję usługi sieciowej. Ten projektowanie usługi sieciowej jest szablonem używanym w zasobie usługi sieciowej strony, który wdroży funkcję sieciową, którą zintegrowałeś w poprzednich sekcjach.

  1. Wygeneruj plik wejściowy NSD rozszerzenia AOSM dla Azure CLI.

    az aosm nsd generate-config --output-file <nsd-output-filename.jsonc>

  2. Otwórz plik wejściowy wygenerowany w poprzednim kroku i użyj wbudowanych komentarzy, aby wprowadzić wymagane wartości. Wygenerowany plik wejściowy zawiera dodatkowy resource_element_type typ ArmTemplate. To nie jest potrzebne podczas wdrażania VNF; można to usunąć. W tym przykładzie pokazano plik wejściowy rozszerzenia Az CLI AOSM dla fikcyjnej sieciowej domeny usług (NSD) firmy Contoso, który może służyć do wdrożenia fikcyjnej funkcji sieci wirtualnej (VNF) firmy Contoso na instancji Azure Operator Nexus.

    {
    // Azure location to use when creating resources e.g uksouth
    "location": "eastus",
    // Name of the Publisher resource you want your definition published to.
    // Will be created if it does not exist.
    "publisher_name": "contoso",
    // Resource group for the Publisher resource.
    // Will be created if it does not exist.
    "publisher_resource_group_name": "contoso-vnf",
    // Name of the ACR Artifact Store resource.
    // Will be created if it does not exist.
    "acr_artifact_store_name": "contoso-vnf-artifact-store",
    // Network Service Design (NSD) name. This is the collection of Network Service Design Versions. Will be created if it does not exist.
    "nsd_name": "contoso-vnf-nsd",
    // Version of the NSD to be created. This should be in the format A.B.C
    "nsd_version": "1.0.0",
    // Optional. Description of the Network Service Design Version (NSDV).
    "nsdv_description": "An NSD that deploys the onboarded contoso-vnf NFD",
    // List of Resource Element Templates (RETs).
    // There must be at least one NF RET.
    // ArmTemplate RETs are optional. Delete if not required.
    "resource_element_templates": [
        {
            // Type of Resource Element. Either NF or ArmTemplate
            "resource_element_type": "NF",
            "properties": {
                // The name of the existing publisher for the NSD.
                "publisher": "contoso",
                // The resource group that the publisher is hosted in.
                "publisher_resource_group": "contoso-vnf",
                // The name of the existing Network Function Definition Group to deploy using this NSD.
                // This will be the same as the NF name if you published your NFDV using the CLI.
                "name": "contoso-vnf",
                // The version of the existing Network Function Definition to base this NSD on.
                // This NSD will be able to deploy any NFDV with deployment parameters compatible with this version.
                "version": "1.0.0",
                // The region that the NFDV is published to.
                "publisher_offering_location": "eastus",
                // Type of Network Function. Valid values are 'cnf' or 'vnf'.
                "type": "vnf"
            }
        }
    ]
}

    Uwaga / Notatka

    W sekcji szablonu elementu zasobu określono, który NFD jest zawarty w NSD. Właściwości muszą być zgodne z właściwościami używanymi w pliku wejściowym przekazanym przez polecenie az aosm nfd build. Dzieje się tak, ponieważ rozszerzenie CLI AOSM platformy Azure sprawdza, czy NFD został poprawnie wdrożony podczas tworzenia NSD.

  3. Wykonaj następujące polecenie, aby skompilować pliki Grupy Projektowania Usługi Sieciowej oraz pliki wersji Bicep.

az aosm nsd build --config-file <nsd-output-filename.jsonc>

W razie potrzeby możesz przejrzeć strukturę folderów i plików oraz wprowadzić modyfikacje.

Publikowanie projektu usługi sieciowej (NSD)

W tym kroku zostaną utworzone zasoby AOSM, które definiują grupę projektową i wersję usługi sieciowej. Przekazuje również zasoby wymagane przez Deskryptor Usługi Sieciowej (NSD) do repozytorium artefaktów (szablon ARM funkcji sieciowej).

  1. Wykonaj następujące polecenie, aby opublikować grupę projektową i wersję usługi sieciowej. Jeśli nie masz zakresu subskrypcji Contributor i ról AcrPush, uwzględnij --no-subscription-permissions w poleceniu.
az aosm nsd publish --build-output-folder nsd-cli-output

Masz teraz kompletny zestaw zasobów wydawcy AOSM i możesz przystąpić do wykonywania procesu operatorskiego.

Dalsze kroki