Share via


Guia de início rápido: projetar um projeto de serviço de rede CNF (função de rede em contêiner) com Nginx

Este guia de início rápido descreve como usar a extensão CLI do az aosm Azure para criar e publicar um Design de Serviço de Rede básico.

Pré-requisitos

Criar arquivo de entrada

Crie um arquivo de entrada para publicar o Design do Serviço de Rede. Execute o seguinte comando para gerar o arquivo de configuração de entrada para o Network Service Design (NSD).

az aosm nsd generate-config

A execução do comando anterior gera um arquivo input.json.

Nota

Edite o arquivo input.json. Substitua-o pelos valores mostrados na amostra. Salve o arquivo como input-cnf-nsd.json.

Aqui está um exemplo de input-cnf-nsd.json:

{
    "publisher_name": "nginx-publisher",
    "publisher_resource_group_name": "nginx-publisher-rg",
    "acr_artifact_store_name": "nginx-nsd-acr",
    "location": "uksouth",
    "network_functions": [
        {
            "publisher": "nginx-publisher",
            "publisher_resource_group": "nginx-publisher-rg",
            "name": "nginx-nfdg",
            "version": "1.0.0",
            "publisher_offering_location": "uksouth",
            "type": "cnf",
            "multiple_instances": false
        }
    ],
    "nsd_name": "nginx-nsdg",
    "nsd_version": "1.0.0",
    "nsdv_description": "Deploys a basic NGINX CNF"
}
  • publisher_name - Nome do recurso do Publisher para o qual pretende publicar a sua definição. Criado se ainda não existir.
  • publisher_resource_group_name - Grupo de recursos para o recurso Publicador. Criado se ainda não existir. Para este início rápido, é recomendável usar o mesmo Grupo de Recursos que você usou ao publicar a Definição de Função de Rede.
  • acr_artifact_store_name - Nome do recurso ACR Artifact Store. Criado se ainda não existir.
  • location - O local do Azure a ser usado ao criar recursos.
  • network_function:
    • publisher - O nome do editor sob o qual este NFDV é publicado.
    • publisher_resource_group - O grupo de recursos no qual o editor está hospedado.
    • name - O nome do Grupo de Definição de Função de Rede existente a ser implantado usando esta NSD.
    • version - A versão da definição de função de rede existente para basear esta NSD. Esta NSD é capaz de implantar qualquer NFDV com parâmetros de implantação compatíveis com esta versão.
    • publisher_offering_location - A região para a qual o NFDV é publicado.
    • type - Tipo de função de rede. Os valores válidos são cnf ou vnf.
    • multiple_instances - Os valores válidos são true ou false. Controla se a NSD deve permitir números arbitrários deste tipo de novos alimentos. Se definido como false, apenas uma única instância será permitida. Suportado apenas em VNFs. Para CNFs, esse valor deve ser definido como false.
  • nsd_name - O nome do Grupo de Design de Serviço de Rede. A coleção de versões do Network Service Design. Criado se ainda não existir.
  • nsd_version - A versão da NSD que está a ser criada. No formato de A.B.C.
  • nsdv_description - A descrição da NSDV.

Criar o projeto de serviço de rede (NSD)

Inicie o processo de compilação para a definição de serviço de rede (NSD) usando o seguinte comando:

az aosm nsd build -f input-cnf-nsd.json

Após a conclusão do processo de compilação, reveja os ficheiros gerados para obter informações sobre a arquitetura e a estrutura da NSD.

Estes ficheiros são criados:

Files Description
artifact_manifest.bicep Um modelo de bíceps para criar o Publisher e lojas de artefatos.
configMapeamentos Converte as entradas de valores do grupo de configuração para os parâmetros de implantação necessários para cada NF.
nsd_definition.bicep Um modelo de bíceps para criar o próprio NSDV.
Esquemas Define as entradas necessárias nos valores do grupo de configuração para este NSDV.
nginx-nfdg_nf.bicep Um modelo de bíceps para implantar o NF. Carregado para a loja de artefatos.

Publicar o projeto de serviço de rede (NSD)

Para publicar o Network Service Design (NSD) e seus artefatos associados, emita o seguinte comando:

az aosm nsd publish -f input-cnf-nsd.json

Quando o processo de publicação estiver concluído, navegue até o Grupo de Recursos do Publisher para observar e revisar os recursos e artefatos produzidos.

Próximos passos