Atualizar e confirmar recursos do Network Fabric

Atualmente, os recursos do Nexus Network Fabric exigem que você desabilite um recurso pai (como um domínio L3Isolation) e recoloque o recurso pai ou filho com valores atualizados e execute a ação de postagem administrativa para habilitar e configurar os dispositivos. O novo fluxo de atualização de recursos do Network Fabric permite que você agrupe e atualize um conjunto de recursos do Network Fabric por meio de uma commitConfiguration ação POST quando os recursos estiverem habilitados. Não haverá alteração se você escolher o fluxo de trabalho atual de desabilitar o domínio de Isolamento L3, fazer alterações e habilitar o domínio de Isolamento L3.

Observação

Como parte de nossos esforços contínuos para melhorar a eficiência operacional e a confiabilidade, estamos anunciando que o novo fluxo de trabalho do Fabric Commit v2 se tornará o fluxo de trabalho de confirmação padrão a partir da versão 2507.1 do Azure Operator e o commit v1 será descontinuado. Consulte Commit Workflow v2 no Azure Operator Nexus - Network Fabric

Visão geral da atualização de recursos do Network Fabric

Qualquer operação de Criar, Atualizar, Excluir (CUD) em um recurso filho associado a um recurso pai existente e habilitado ou uma atualização de uma propriedade de recurso pai habilitado é considerada uma operação de Atualização. Alguns exemplos seriam uma nova rede interna ou uma nova sub-rede precisa ser adicionada a um domínio de isolamento de camada 3 habilitado existente (rede interna é um recurso filho do domínio de isolamento de camada 3). É necessário anexar uma nova política de rotas à rede interna existente; ambos os cenários se qualificam para uma operação de atualização .

Qualquer operação de atualização executada em recursos de malha de rede suportados mostrados na tabela a seguir coloca a malha em um estado de confirmação pendente (atualmente Aceito no estado de configuração), onde você deve iniciar uma ação de configuração de confirmação de malha para aplicar as alterações desejadas. Todas as atualizações dos recursos do Network Fabric (incluindo recursos filho) na malha seguem o mesmo fluxo de trabalho.

As ações/confirmações de atualização de recursos só serão válidos e aplicáveis quando a malha estiver no estado provisionado e os recursos da malha de rede estiverem num estado administrativo ativado. É possível agrupar as atualizações dos recursos pai e filho em lotes (em vários recursos do Network Fabric) e uma commitConfiguration ação pode ser executada para aplicar todas as alterações numa única ação POST.

A criação de recursos pai e a habilitação por meio de ação administrativa são independentes do fluxo de trabalho da Ação de Atualização/Confirmação. Além disso, todas as ações administrativas para ativar/desabilitar são independentes e não devem exigir o gatilho da ação commitConfiguration para execução. A ação CommitConfiguration é aplicável somente quando o operador deseja atualizar quaisquer recursos existentes do Azure Resource Manager e a infraestrutura, desde que o recurso pai esteja no estado ativado. Quaisquer scripts de automação ou arquivos Bicep que foram usados pelos operadores para criar o recurso Network Fabric e habilitar não exigem alterações.

Fluxo de trabalho do usuário

Para executar com êxito os recursos de atualização, a malha deve estar no estado provisionado. As etapas a seguir estão envolvidas na atualização dos recursos do Network Fabric.

O operador atualiza os recursos necessários do Network Fabric (várias atualizações de recursos podem ser enviadas em lote) que já estavam habilitados (configuração aplicada a dispositivos) usando a chamada de atualização nos recursos do Network Fabric via AzCli, Azure Resource Manager, Portal. (Consulte os detalhes dos cenários, recursos e parâmetros suportados na tabela a seguir).

No exemplo a seguir, um novo internalnetwork é adicionado a um L3Isolation l3domain101523-sm existente.
```
az networkfabric internalnetwork create --subscription 5ffad143-8f31-4e1e-b171-fa1738b14748 --resource-group "Fab3Lab-4-1-PROD" --l3-isolation-domain-name "l3domain101523-sm" --resource-name "internalnetwork101523" --vlan-id 789 --mtu 1432 --connected-ipv4-subnets "[{prefix:'10.252.11.0/24'},{prefix:'10.252.12.0/24'}]
```
Quando a chamada de atualização do Azure Resource Manager for bem-sucedida, o recurso ConfigurationState específico será definido como Aceito e, quando falhar, será definido como Rejeitado. A malha ConfigurationState está definida como Aceito, independentemente do sucesso/falha da chamada PATCH.

Se qualquer recurso do Azure Resource Manager na malha (como Rede Interna ou RoutePolicy) estiver no estado Rejeitado , o Operador deverá corrigir a configuração e garantir que o ConfigurationState do recurso específico esteja definido como Aceito antes de prosseguir.

O operador executa a ação commitConfiguration POST no recurso Fabric.

az networkfabric fabric commit-configuration --subscription 5ffad143-8f31-4e1e-b171-fa1738b14748 --resource-group "FabLAB-4-1-PROD" --resource-name "nffab3-4-1-prod"

O serviço valida se todas as atualizações de recursos foram bem-sucedidas e valida as entradas. Ele também valida recursos lógicos conectados para garantir um comportamento e configuração consistentes. Quando todas as validações forem bem-sucedidas, a nova configuração é gerada e enviada para os dispositivos.
O recurso configurationState específico é redefinido para Êxito e o Tecido configurationState é configurado como Provisionado.
Se a commitConfiguration ação falhar, o serviço exibirá a mensagem de erro apropriada e notificará o operador sobre a possível falha de atualização de recursos do Network Fabric.

Estado	Definition	Antes da Atualização de Recursos do Azure Resource Manager	Antes da atualização CommitConfiguration & Post Azure Resource Manager	Pós-CommitConfiguration
Estado administrativo	Estado para representar a ação administrativa executada no recurso	Ativado (apenas ativado é suportado)	Ativado (apenas ativado é suportado)	Ativado (o usuário pode desativar)
Estado de configuração	Estado para representar as ações do operador/configurações orientadas por serviço	Estado do recurso - Concluído com sucesso Estado da malha Provisionado	Estado do recurso - Aceito (Sucesso) - Rejeitado (Falha) Estado do Fabric - Aceito	Estado do recurso - Aceito (Falha) - Sucesso (Êxito) Estado do Tecido - Aprovisionado
Estado de Aprovisionamento	Estado para representar o estado de provisionamento de recursos do Azure Resource Manager	Aprovisionado	Aprovisionado	Aprovisionado

Recursos e cenários de malha de rede suportados

Suporte à atualização do Network Fabric Recursos do Network Fabric (Network Fabric 4.1, Nexus 2310.1)

Recurso de malha de rede	Tipo	Cenários suportados	Cenários não suportados	Observações
Domínio de isolamento da camada 2	Parent	- Atualização de propriedades – MTU - Adição/atualização de tags	Re-PUT do recurso
Domínio de isolamento da camada 3	Parent	Atualizar propriedades - redistribuir conectado. - redistribuir rotas estáticas. - Configuração de rotas agregadas - política de rotas de subredes conectadas. Tags de adição/atualização	Re-PUT do recurso
Rede Interna	Criança (de L3 ISD)	Adicionar uma nova rede interna Atualização de propriedades - MTU - Adição/Atualização de sub-redes IPv4/IPv6 conectadas - Adição/Atualização de IPv4/IPv6 RoutePolicy - Adição/Atualização de ACL de Saída/Entrada - Atualizar sinalizador `isMonitoringEnabled` - Adição/Atualização de rotas estáticas - Configuração BGP Tags de adição/atualização	- Re-PUT de recurso. - Excluir uma rede interna quando o domínio de isolamento da camada 3 pai estiver habilitado.	Para eliminar o recurso, o recurso pai deve ser desativado
Rede Externa	Criança (de L3 ISD)	Atualização das propriedades - Adição/Atualização de IPv4/IPv6 RoutePolicy - Propriedades MTU da Opção A, Adição/Atualização de ACLs de Entrada e Saída, - Propriedades da Opção A – Configuração BFD - Propriedades da Opção B – Destinos de Rota Adição/Atualização de tags	- Re-PUT de recurso. - Criação de uma nova rede externa - Excluir uma rede externa quando o domínio de isolamento da camada 3 pai estiver habilitado.	Para eliminar o recurso, o recurso pai deve ser desativado. NOTA: Apenas uma rede externa é suportada por ISD.
Política de Rotas	Parent	- Atualize toda a declaração, incluindo número de seq, condição, ação. - Adição/atualização de tags	- Re-PUT de recurso. - Atualização da Política de Rotas vinculada a um recurso de Interconexão Rede-a-Rede.	Para excluir o recurso, a `connectedResource` (`IsolationDomain` ou interconexão N-para-N) não deve conter nenhuma referência.
IPCommunity	Parent	Atualize toda a regra ipCommunity, incluindo número de sequência, ação, membros da comunidade, comunidades conhecidas.	Re-PUT do recurso	Para excluir o recurso, o recurso conectado `RoutePolicy` não deve conter nenhuma referência.
Prefixos de IP	Parent	- Atualize toda a regra IPPrefix, incluindo número de sequência, prefixo de rede, condição e comprimento da máscara de sub-rede. - Adição/atualização de tags	Re-PUT do recurso	Para excluir o recurso, o recurso conectado `RoutePolicy` não deve conter nenhuma referência.
IPExtendedCommunity	Parent	- Atualize toda a regra da comunidade IPExtended, incluindo número de sequência, ação, alvos de rota. - Adição/atualização de tags	Re-PUT do recurso	Para excluir o recurso, o recurso conectado `RoutePolicy` não deve conter nenhuma referência.
ACLs	Parent	- Adição/Atualização para combinar configurações de referência e configurações de referência dinâmica. - Atualização do tipo de configuração - Adição/atualização das ACLs URL - Adição/atualização de tags	- Re-PUT de recurso. - Atualização para ACLs associadas a um recurso de interconexão de rede a rede.	Para excluir o recurso, o `connectedResource` (como `IsolationDomain` ou Interconexão N-to-N) não deve conter nenhuma referência.

Notas de comportamento e restrições

Se um recurso pai estiver em um estado administrativo Desativado e alterações forem feitas ao recurso pai ou aos recursos filho, a commitConfiguration ação não será aplicável. Habilitar o recurso empurraria a configuração. O caminho de confirmação para esses recursos é acionado somente quando o recurso pai está no estado administrativo Ativado.
Se commitConfiguration falhar, a rede permanecerá em estado de configuração Aceite até que o utilizador resolva os problemas e execute com sucesso um commitConfiguration. Atualmente, apenas são fornecidos mecanismos de avanço quando ocorre uma falha.
Se a configuração de malha estiver em um estado Aceito e tiver atualizações para os recursos do Azure Resource Manager ainda a serem confirmadas, nenhuma ação administrativa será permitida nos recursos.
Se a configuração de malha estiver em um estado Aceito e tiver atualizações para os recursos do Azure Resource Manager ainda a serem confirmadas, a operação de exclusão em recursos com suporte não poderá ser acionada.
A criação de recursos pai é independente de commitConfiguration e do fluxo de atualização. O Re-PUT de recursos não é suportado em nenhum recurso.
A atualização de recursos do Network Fabric é suportada para implantações Greenfield e Brownfield, mas com algumas restrições.
- Na implementação Greenfield, o estado de configuração da estrutura é Aceito assim que se realizarem atualizações nos recursos da estrutura de rede. Depois que a commitConfiguration ação é acionada, ela passa para o estado Provisionado ou Aceito, dependendo do sucesso ou da falha da ação.
- Na implantação do Brownfield, a commitConfiguration ação é suportada, mas os recursos de malha de rede suportados (como domínios de isolamento, redes internas, RoutePolicy ou ACLs) devem ser criados usando a versão de disponibilidade geral da API (2023-06-15). Essa restrição temporária é relaxada após a migração de todos os recursos para a versão mais recente.
- Na implantação do Brownfield, o estado de configuração da malha permanece em um estado provisionado quando há alterações em quaisquer recursos de malha de rede suportados ou a ação commitConfiguration é acionada. Esse comportamento é temporário até que todas as malhas sejam migradas para a versão mais recente.
As atualizações da política de rota e outros recursos relacionados (comunidade IP, comunidade IP estendida, lista de prefixos IP) são consideradas como uma operação de substituição de lista. Todas as instruções existentes são removidas e apenas as novas instruções atualizadas são configuradas.
A atualização ou remoção de sub-redes, rotas, configurações BGP e outros parâmetros de rede relevantes existentes na configuração de rede interna ou externa pode causar interrupção de tráfego e deve ser realizada a critério dos operadores.
A atualização de novas políticas de rota e ACLs pode causar interrupção do tráfego, dependendo das regras aplicadas.
Use um comando list no tipo de recurso específico (liste todos os recursos de um tipo de rede interna) para verificar os recursos que estão atualizados e não estão comprometidos com o dispositivo. Os recursos que têm um estado de configuração Aceito ou Rejeitado podem ser filtrados e identificados como recursos que ainda não foram confirmados ou onde a confirmação no dispositivo falha.

Por exemplo:

az networkfabric internalnetwork list --resource-group "example-rg" --l3domain  "example-l3domain"

Feedback

Esta página foi útil?

Last updated on 2025-09-19