Gerenciar conjuntos nomeados

Neste guia, descrevemos como fazer as seguintes atualizações nos conjuntos nomeados para políticas de rota do BGP do Cloud Router:

  • Listar conjuntos nomeados
  • Remover conjuntos nomeados
  • Atualizar conjuntos nomeados
  • Adicionar elementos de conjunto nomeado
  • Remover elementos de um conjunto nomeado

Listar conjuntos nomeados em um roteador

Use o comando list-named-sets para conferir os nomes e tipos de conjuntos nomeados definidos em um único roteador.

gcloud compute routers list-named-sets ROUTER_NAME

Substitua ROUTER_NAME pelo nome do seu Cloud Router.

Remover um conjunto nomeado

Se um conjunto nomeado for referenciado em alguma política de rota do BGP no roteador, não será possível remover o conjunto nomeado.

gcloud compute routers remove-named-set ROUTER_NAME
    --set-name=SET_NAME

Substitua:

  • ROUTER_NAME: o nome do seu Cloud Router
  • SET_NAME: o nome do conjunto nomeado que você quer remover.

Atualizar um conjunto nomeado em um roteador

Ao atualizar um conjunto nomeado, recomendamos que você faça o download dele do roteador em formato YAML ou JSON usando o comando download-named-set. Edite o arquivo YAML ou JSON localmente e faça upload do arquivo atualizado para o roteador usando o comando upload-named-set. O comando upload-named-set substitui o conjunto nomeado atual.

O arquivo baixado do roteador inclui o campo fingerprint, que o Cloud Router usa para corresponder ao conjunto nomeado atual e evitar atualizações conflitantes.

  1. Para fazer o download do conjunto nomeado, execute o comando download-named-set: 

    gcloud compute routers download-named-set ROUTER_NAME
    --set-name=SET_NAME
    --file-name=FILE_NAME
    --file-format=FORMAT

    Substitua:

    • ROUTER_NAME com o nome do Cloud Router.
    • SET_NAME pelo nome do conjunto.
    • FILE_NAME com o nome de arquivo que você quer para o conjunto nomeado, incluindo o caminho e a extensão do nome de arquivo.
    • FORMAT com o formato do conjunto nomeado, JSON ou YAML.

  2. Modifique o conjunto nomeado baixado no editor de texto de sua preferência usando a formatação JSON ou YAML.

    Os exemplos a seguir usam dois arquivos YAML para atualizar conjuntos nomeados allowed-prefixes e allowed-communities.

    allowed-prefixes.yaml:

    # Prefix set
resource:
  elements:
  - expression: "'192.168.1.0/24'"
  - expression: "'fd00::/8'"
  - expression: "prefix('10.0.0.0/20').orLonger()"
  name: allowed-prefixes
  type: NAMED_SET_TYPE_PREFIX

    allowed-communities.yaml:

    # Community set
resource:
  elements:
  - expression: "'64500:100'"
  - expression: "'64500:300'"
  name: allowed-communities
  type: NAMED_SET_TYPE_COMMUNITY

  3. Para fazer upload do conjunto nomeado, execute o comando upload-named-set: 

    gcloud compute routers upload-named-set ROUTER_NAME
    --set-name=SET
    --file-name=NAME
    --file-format=FORMAT

    Substitua:

    • ROUTER_NAME com o nome do Cloud Router.
    • SET pelo nome do conjunto.
    • NAME com o local e o nome do arquivo YAML ou JSON que você editou.
    • FORMAT com o formato do conjunto nomeado, JSON ou YAML.

Adicionar um elemento de conjunto nomeado

Execute este comando:

gcloud compute routers add-named-set-element ROUTER_NAME
    --set-name=SET_NAME
    --new-set-element=CEL_EXPRESSION

Substitua:

  • ROUTER_NAME: o nome do seu Cloud Router
  • SET_NAME: o nome do conjunto nomeado que você quer atualizar.
  • CEL_EXPRESSION: um elemento a ser adicionado ao conjunto, expresso em Common Expression Language (CEL)

Remover um elemento de um conjunto nomeado

Execute este comando:

gcloud compute routers remove-named-set-element ROUTER_NAME
    --set-name=SET_NAME
    --set-element=CEL_EXPRESSION

Substitua:

  • ROUTER_NAME: o nome do seu Cloud Router
  • SET_NAME: o nome do conjunto nomeado que você quer atualizar.
  • CEL_EXPRESSION: um elemento a ser removido do conjunto, expresso em Common Expression Language (CEL)

A seguir