Use o espelhamento de pacotes

Consola

1. Na Google Cloud consola, aceda à página Packet Mirroring.

   Aceda à funcionalidade Packet Mirroring

2. Clique em Criar política.

3. Introduza as seguintes informações acerca da política e, de seguida, clique em Continuar.

   1. Introduza um nome para a política.
   2. Selecione a região que inclui as origens espelhadas e o destino do coletor. A política de espelhamento de pacotes tem de estar na mesma região que a origem e o destino.
   3. Ignore o campo Prioridade. De momento, não é possível ajustá-lo.
   4. Selecione Ativado para ativar a política quando a criar.

4. Selecione as redes VPC onde se encontram a origem espelhada e o destino do coletor e, de seguida, clique em Continuar.

   A origem e o destino podem estar na mesma ou em diferentes redes VPC.

   • Se estiverem na mesma rede de VPC, selecione As origens e o destino espelhados estão na mesma rede de VPC e, em seguida, selecione a rede.
   • Se estiverem em redes diferentes, selecione A origem espelhada e o destino do coletor estão em redes de VPC separadas e com peering e, em seguida, selecione a rede de origem espelhada e, depois, a rede de destino do coletor.

5. Selecione as origens espelhadas e, de seguida, clique em Continuar. Pode selecionar uma ou mais fontes. Google Cloud reflete qualquer instância que corresponda a, pelo menos, uma das fontes selecionadas.

   • Sub-redes: selecione uma ou mais sub-redes. Google Cloud reflete as instâncias existentes e futuras nas sub-redes selecionadas.
   • Etiqueta de rede: especifique uma ou mais etiquetas de rede. Google Cloud reflete instâncias que têm, pelo menos, uma das etiquetas especificadas.
   • Nome da instância: selecione instâncias específicas para espelhar.

6. Selecione um balanceador de carga de rede de encaminhamento interno que tenha sido configurado para a replicação de pacotes e, de seguida, clique em Continuar. Google Cloud envia tráfego replicado para instâncias que estão atrás do balanceador de carga de rede de encaminhamento interno.

   Para a VPC partilhada, se o destino do coletor e as origens duplicadas estiverem na mesma rede de VPC partilhada, tem de selecionar o projeto onde o destino do coletor está localizado e, em seguida, selecionar um equilibrador de carga.

7. Para selecionar o tráfego a duplicar, faça o seguinte:

   • Para espelhar todo o tráfego IPv4, selecione Espelhar todo o tráfego IPv4 (predefinição).
   • Para duplicar todo o tráfego IPv4 e IPv6, selecione Duplicar tráfego filtrado e, de seguida, faça o seguinte:
     • Selecione Permitir todos os protocolos.
     • Selecione Permitir todos os intervalos IPv4 (0.0.0.0/0).
     • Selecione Permitir todos os intervalos de IPv6 (::/0).
     • Selecione Permitir tráfego de entrada e saída.

   • Para limitar o tráfego espelhado, selecione Espelhar tráfego filtrado e, de seguida, faça o seguinte:

     • Para limitar o tráfego espelhado por protocolo, selecione Permitir protocolos específicos e, em seguida, selecione os protocolos. Se não vir um protocolo para o qual quer espelhar o tráfego, selecione Outros protocolos e, de seguida, introduza o protocolo no campo Outros protocolos. Os valores válidos são tcp, udp, esp, ah, ipip, sctp ou um número de protocolo da IANA. Para especificar ICMP para IPv6, introduza 58.

     • Para filtros de intervalo IPv4, faça o seguinte:

       • Para duplicar todo o tráfego IPv4, selecione Permitir todos os intervalos IPv4 (0.0.0.0/0).
       • Para duplicar o tráfego de intervalos de endereços IPv4 específicos, selecione Permitir intervalos IPv4 específicos. No campo Intervalos IPv4, escreva um único intervalo de endereços IPv4 e, de seguida, prima Enter. Pode adicionar vários intervalos IPv4 premindo Enter após cada intervalo que introduzir.

     • Para filtros de intervalo IPv6, faça o seguinte:

       • Para filtrar todo o tráfego IPv6, selecione Nenhum.
       • Para duplicar todo o tráfego IPv6, selecione Permitir todos os intervalos IPv6 (::/0).
       • Para duplicar o tráfego de intervalos de endereços IPv6 específicos, selecione Permitir intervalos IPv6 específicos. No campo Intervalos IPv6, escreva um único intervalo de endereços IPv6 e, de seguida, prima Enter. Pode adicionar vários intervalos IPv6 premindo Enter após cada intervalo que escrever.

8. Selecione a direção do trânsito que quer duplicar.

9. Para criar a política de espelhamento de pacotes, clique em Enviar.

gcloud

Para criar uma política de espelhamento de pacotes, use o comando packet-mirrorings create.

gcloud compute packet-mirrorings create POLICY_NAME \
    --region=REGION \
    --network=NETWORK_NAME \
    --collector-ilb=FORWARDING_RULE_NAME \
    [--mirrored-subnets=SUBNET,[SUBNET,...]] \
    [--mirrored-tags=TAG,[TAG,...]] \
    [--mirrored-instances=INSTANCE,[INSTANCE,...]] \
    [--filter-cidr-ranges=CIDR_RANGE,[CIDR_RANGE,...]] \
    [--filter-protocols=PROTOCOL,[PROTOCOL,...]] \
    [--filter-direction=DIRECTION]

Substitua o seguinte:

• POLICY_NAME: o nome da política de espelhamento de pacotes.
• REGION: a região onde se encontram as origens espelhadas e o destino do coletor.
• NETWORK_NAME: a rede onde se encontram as fontes espelhadas.
• FORWARDING_RULE_NAME: o nome da regra de encaminhamento que está configurada como um coletor de espelhamento. Google Cloud envia todo o tráfego espelhado para o balanceador de carga de rede de passagem interno associado.
• SUBNET: o nome de uma ou mais sub-redes a replicar. Pode fornecer várias sub-redes através de uma lista separada por vírgulas. Google Cloud reflete instâncias existentes e futuras na sub-rede.
• TAG: uma ou mais etiquetas de rede. Google Cloud reflete instâncias que têm a etiqueta de rede. Pode fornecer várias etiquetas através de uma lista separada por vírgulas.
• INSTANCE: o ID totalmente qualificado de uma ou mais instâncias a replicar. Pode fornecer várias instâncias através de uma lista separada por vírgulas.
• CIDR_RANGE: um ou mais intervalos CIDR IPv4 ou IPv6 para replicar. Se não forem especificados intervalos CIDR, todo o tráfego IPv4 que corresponda aos protocolos especificados é replicado. Se não forem especificados intervalos CIDR nem protocolos, todo o tráfego IPv4 é espelhado. Para espelhar todo o tráfego IPv4 e IPv6, use 0.0.0.0/0,::/0. Pode incluir intervalos CIDR IPv4 e IPv6. Pode fornecer vários intervalos através de uma lista separada por vírgulas.
• PROTOCOL: um ou mais protocolos para espelhar. Os valores válidos são tcp, udp, icmp, esp, ah, ipip, sctp ou um número de protocolo da IANA. Se não forem especificados protocolos, todo o tráfego que corresponda aos intervalos CIDR especificados é replicado. Se não forem especificados protocolos nem intervalos CIDR, todo o tráfego IPv4 é espelhado. Para especificar ICMP para IPv6, use 58. Pode fornecer vários protocolos através de uma lista separada por vírgulas.
• DIRECTION: a direção do tráfego a replicar em relação à VM. Por predefinição, esta opção está definida como both, o que significa que o tráfego de entrada e de saída é espelhado. Pode restringir os pacotes capturados especificando ingress para capturar apenas pacotes de entrada ou egress para capturar apenas pacotes de saída.

Terraform

Pode usar um recurso do Terraform para criar uma política de espelhamento de pacotes.

resource "google_compute_packet_mirroring" "default" {
  region      = "europe-west1"
  name        = "my-mirroring"
  description = "My packet mirror"
  network {
    url = google_compute_network.ilb_network.id
  }
  collector_ilb {
    url = google_compute_forwarding_rule.default.id
  }
  mirrored_resources {
    tags = ["foo"]
    instances {
      url = google_compute_instance.vm_test.id
    }
  }
  filter {
    ip_protocols = ["tcp"]
    cidr_ranges  = ["0.0.0.0/0"]
    direction    = "BOTH"
  }
}

Para saber como aplicar ou remover uma configuração do Terraform, consulte os comandos básicos do Terraform.

API

Para criar uma política de espelhamento de pacotes, faça um pedido POST ao método packetMirrorings.insert.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/packetMirrorings
{
  "name": "POLICY_NAME",
  "enable": "ENABLED",
  "network": {
    "url": "NETWORK_URL"
  },
  "priority": PRIORITY,
  "mirroredResources": {
    "subnetworks": [
      {
        "url": "SUBNET_URL"
      }
    ],
    "tags": [
      "TAG"
    ],
    "instances": [
      {
        "url": "INSTANCE"
      }
    ]
  },
  "collectorIlb": {
    "url": "FORWARDING_RULE_URL"
  },
  "filter": {
    "IPProtocols": [
      "PROTOCOL"
    ],
    "cidrRanges": [
      "CIDR_RANGE"
    ],
    "direction": "DIRECTION"
  }
}

Substitua o seguinte:

• PROJECT_ID: o ID do projeto no qual criar a política.
• REGION: a região onde se encontram as origens espelhadas e o destino do coletor.
• POLICY_NAME: o nome da política de espelhamento de pacotes.
• ENABLED: se esta política entra em vigor ou não. As opções são TRUE e FALSE. TRUE é a predefinição.
• NETWORK_URL: o URL da rede onde se encontram as fontes refletidas.
• PRIORITY: a prioridade da regra de encaminhamento, que é usada para desempatar quando existe mais do que uma regra correspondente. O intervalo válido é de 0 a 65 535 e o valor predefinido é 1000.
• SUBNET_URL: o URL de uma sub-rede a duplicar. Google Cloud Duplica as instâncias existentes e futuras na sub-rede. Pode fornecer várias sub-redes através de uma lista separada por vírgulas.
• TAG: uma etiqueta de rede. Google Cloud reflete instâncias que têm a etiqueta de rede. Pode fornecer várias etiquetas através de uma lista separada por vírgulas.
• INSTANCE: o ID totalmente qualificado de uma instância a duplicar. Pode fornecer várias instâncias através de uma lista separada por vírgulas.
• FORWARDING_RULE_URL: o URL de uma regra de encaminhamento que está configurada como um coletor de replicação. Google Cloud envia todo o tráfego replicado para o balanceador de carga de rede de passagem interno associado.
• PROTOCOL: um ou mais protocolos. As opções são tcp, udp, icmp, esp, ah, ipip, sctp ou um número de protocolo da IANA. Se não forem especificados protocolos, todo o tráfego que corresponda aos intervalos CIDR especificados é duplicado. Se não forem especificados intervalos CIDR nem protocolos, todo o tráfego IPv4 é espelhado. Para especificar ICMP para IPv6, introduza 58. Pode fornecer vários protocolos através do seguinte formulário: "icmp", "udp".
• CIDR_RANGE: um ou mais intervalos CIDR IPv4 ou IPv6 para replicar. Se não forem especificados intervalos CIDR, todo o tráfego IPv4 que corresponda aos protocolos especificados é replicado. Se não forem especificados intervalos CIDR nem protocolos, todo o tráfego IPv4 é espelhado. Para espelhar todo o tráfego IPv4 e IPv6, use "0.0.0.0/0", "::/0". Pode incluir intervalos CIDR IPv4 e IPv6. Pode fornecer vários intervalos CIDR através do seguinte formulário: "192.0.2.0/24", "2001:0DB8::/32".
• PROTOCOL: um ou mais protocolos para espelhar.
• DIRECTION: a direção do tráfego a espelhar. As opções são INGRESS, EGRESS ou BOTH. A predefinição é BOTH.

Consola

1. Na Google Cloud consola, aceda à página Packet Mirroring.

   Aceda à funcionalidade Packet Mirroring

2. Na lista de políticas de replicação de pacotes, clique na que quer editar.

3. Na página de detalhes da política, clique em Editar.

4. Edite os campos que quer atualizar. A consola segue o mesmo fluxo que os passos para quando cria uma política. Para ver informações sobre cada campo, consulte o artigo Crie uma política de espelhamento de pacotes.

gcloud

Para atualizar uma política de espelhamento de pacotes existente, use o comando packet-mirrorings update.

gcloud compute packet-mirrorings update POLICY_NAME [--async] \
  [--collector-ilb=FORWARDING_RULE_NAME] [--description=DESCRIPTION] [--enable] \
  [--filter-direction=DIRECTION] [--region=REGION] \
  [--add-filter-cidr-ranges=[CIDR_RANGE,...] | --clear-filter-cidr-ranges \
    | --remove-filter-cidr-ranges=[CIDR_RANGE,...] \
    | --set-filter-cidr-ranges=[CIDR_RANGE,...]] \
  [--add-filter-protocols=[PROTOCOL,...] | --clear-filter-protocols \
    | --remove-filter-protocols=[PROTOCOL,...] \
    | --set-filter-protocols=[PROTOCOL,...]] \
  [--add-mirrored-instances=[INSTANCE,...] | --clear-mirrored-instances \
    | --remove-mirrored-instances=[INSTANCE,...] \
    | --set-mirrored-instances=[INSTANCE,...]] \
  [--add-mirrored-subnets=[SUBNET,...] | --clear-mirrored-subnets \
    | --remove-mirrored-subnets=[SUBNET,...] \
    | --set-mirrored-subnets=[SUBNET,...]] \
  [--add-mirrored-tags=[TAG,...] | --clear-mirrored-tags \
    | --remove-mirrored-tags=[TAG,...] | --set-mirrored-tags=[TAG,...]]

Substitua o seguinte:

• POLICY_NAME: o nome da política de espelhamento de pacotes a modificar.
• FORWARDING_RULE_NAME: o nome da regra de encaminhamento que está configurada como um coletor. Google Cloud envia todo o tráfego espelhado para o Network Load Balancer de passagem interno associado.
• DESCRIPTION: uma descrição da política de espelhamento de pacotes.
• DIRECTION: a direção do tráfego à qual aplicar a política de espelhamento de pacotes. As opções são egress, ingress ou both.
• REGION: a região onde a política se encontra.
• CIDR_RANGE: um ou mais intervalos CIDR IPv4 ou IPv6 para replicar. Se não forem especificados intervalos CIDR, todo o tráfego IPv4 que corresponda aos protocolos especificados é replicado. Se não forem especificados intervalos CIDR nem protocolos, todo o tráfego IPv4 é espelhado. Para espelhar todo o tráfego IPv4 e IPv6, use 0.0.0.0/0,::/0. Pode incluir intervalos CIDR IPv4 e IPv6. Pode fornecer vários intervalos através de uma lista separada por vírgulas.
• PROTOCOL: um ou mais protocolos para espelhar. Os valores válidos são tcp, udp, icmp, esp, ah, ipip, sctp ou um número de protocolo da IANA. Se não forem especificados protocolos, o tráfego que corresponder aos intervalos CIDR especificados é espelhado. Se não forem especificados protocolos nem intervalos CIDR, todo o tráfego IPv4 é espelhado. Para especificar ICMP para IPv6, use 58. Pode fornecer vários protocolos através de uma lista separada por vírgulas.
• INSTANCE: o ID totalmente qualificado de uma ou mais instâncias de VM a replicar. Pode fornecer várias instâncias através de uma lista separada por vírgulas.
• SUBNET: uma ou mais sub-redes. Pode fornecer várias sub-redes através de uma lista separada por vírgulas. Google Cloud Reflete as instâncias existentes e futuras na sub-rede.
• TAG: uma ou mais etiquetas de rede. Pode fornecer várias etiquetas através de uma lista separada por vírgulas.

API

Para atualizar uma política de espelhamento de pacotes, faça um pedido POST ao método packetMirrorings.patch.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/packetMirrorings/POLICY_NAME
{
  "name": "POLICY_NAME",
  "description": "DESCRIPTION",
  "priority": "PRIORITY",
  "collectorIlb": {
    "url": "FORWARDING_RULE_URL"
  },
  "mirroredResources": {
    "subnetworks": [
      {
        "url": "SUBNET_URL"
      }
    ],
    "instances": [
      {
        "url": "INSTANCE_URL"
      }
    ],
    "tags": [
      "NETWORK_TAGS"
    ]
  },
  "filter": {
    "cidrRanges": [
      "CIDR_RANGE"
    ],
    "IPProtocols": [
      "PROTOCOL"
    ],
    "direction": "DIRECTION"
  },
  "enable": "ENABLED"
}

Substitua o seguinte:

• PROJECT_ID: o ID do projeto onde a política se encontra.
• REGION: a região da política de espelhamento de pacotes.
• POLICY_NAME: o nome da política de espelhamento de pacotes a modificar.
• DESCRIPTION: uma descrição opcional da política.
• PRIORITY: a prioridade da política, que é usada para desempatar quando existem várias políticas correspondentes. O valor predefinido é 1000. O intervalo válido é de 0 a 65 535.
• FORWARDING_RULE_URL: o URL de uma regra de encaminhamento com o espelhamento de pacotes ativado. Google Cloud envia todo o tráfego espelhado para o Network Load Balancer de passagem interno associado.
• SUBNET_URL: o URL de uma sub-rede. Google Cloud reflete as instâncias existentes e futuras na sub-rede. Pode fornecer várias sub-redes através de uma lista separada por vírgulas.
• INSTANCE_URL: o URL de uma instância de VM para criar uma imagem espelhada. Pode fornecer várias instâncias através de uma lista separada por vírgulas.
• NETWORK_TAGS: uma etiqueta de rede. Google Cloud reflete instâncias que têm uma ou mais etiquetas de rede. Pode fornecer várias etiquetas através de uma lista separada por vírgulas.
• CIDR_RANGE: um ou mais intervalos CIDR IPv4 ou IPv6 para replicar. Se não forem especificados intervalos CIDR, todo o tráfego IPv4 que corresponda aos protocolos especificados é replicado. Se não forem especificados intervalos CIDR nem protocolos, todo o tráfego IPv4 é espelhado. Para espelhar todo o tráfego IPv4 e IPv6, use "0.0.0.0/0", "::/0". Pode incluir intervalos CIDR IPv4 e IPv6. Pode fornecer vários intervalos CIDR através do seguinte formulário: "192.0.2.0/24", "2001:DB8::/32".
• IP_PROTOCOL: um ou mais protocolos. As opções são tcp, udp, icmp, esp, ah, ipip, sctp ou um número de protocolo da IANA. Se não forem especificados protocolos, todo o tráfego que corresponda aos intervalos CIDR especificados é duplicado. Se não forem especificados intervalos CIDR nem protocolos, todo o tráfego IPv4 é espelhado. Para especificar ICMP para IPv6, use 58. Pode fornecer vários protocolos através do seguinte formulário: "icmp", "udp".
• DIRECTION: a direção do tráfego a espelhar. As opções são INGRESS, EGRESS ou BOTH. A predefinição é BOTH.
• ENABLED: indica se a política está ativada ou não. As opções são TRUE ou FALSE.

Consola

• Na Google Cloud consola, aceda à página Packet Mirroring.

  Aceda à funcionalidade Packet Mirroring

  A Google Cloud consola apresenta todas as políticas no seu projeto.

gcloud

Para listar as políticas de replicação de pacotes que estão no seu projeto ou numa região específica, use o comando packet-mirrorings list.

gcloud compute packet-mirrorings list \
  [--filter="region:(REGION...)"]

Substitua REGION pelo nome da região que contém as políticas a listar.

API

Para listar as políticas de espelhamento de pacotes existentes no seu projeto, faça um pedido ao método packetMirrorings.list.GET

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/packetMirrorings

Substitua PROJECT_ID pelo ID do seu projeto.

Para listar as políticas de espelhamento de pacotes existentes para uma região específica, faça um pedido GET ao método packetMirrorings.list.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/packetMirrorings

Substitua o seguinte:

• PROJECT_ID: o ID do projeto que contém as políticas a listar.
• REGION: a região que contém as políticas a apresentar.

Consola

1. Na Google Cloud consola, aceda à página Packet Mirroring.

   Aceda à funcionalidade Packet Mirroring

2. Na lista de políticas de replicação de pacotes, selecione a política que quer ver. A Google Cloud consola mostra os detalhes da política que selecionou.

gcloud

Para descrever uma política de espelhamento de pacotes, use o comando packet-mirrorings describe.

gcloud compute packet-mirrorings describe POLICY_NAME \
  --region=REGION \

Substitua o seguinte:

• POLICY_NAME: o nome da política de espelhamento de pacotes a descrever.
• REGION: a região onde a política se encontra.

API

Para descrever uma política de espelhamento de pacotes, faça um pedido GET ao método packetMirrorings.get.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/packetMirrorings/POLICY_NAME

Substitua o seguinte:

• PROJECT_ID: o ID do projeto onde a política está localizada.
• REGION: a região onde a política se encontra.
• POLICY_NAME: o nome da política de espelhamento de pacotes a descrever.

Consola

1. Na Google Cloud consola, aceda à página Packet Mirroring.

   Aceda à funcionalidade Packet Mirroring

2. Na lista de políticas de replicação de pacotes, selecione a que quer desativar ou ativar.

3. Clique em Desativar ou Ativar.

4. Confirme clicando em Desativar ou Ativar.

gcloud

Para desativar uma política de espelhamento de pacotes, use o comando packet-mirrorings update.

gcloud compute packet-mirrorings update POLICY_NAME \
  --region=REGION \
  --no-enable

Substitua o seguinte:

• POLICY_NAME: o nome da política de espelhamento de pacotes a desativar ou ativar.
• REGION: a região onde a política se encontra.

Para ativar uma política de espelhamento de pacotes, use o comando packet-mirrorings update.

gcloud compute packet-mirrorings update POLICY_NAME \
  --region=REGION \
  --enable

Substitua o seguinte:

• POLICY_NAME: o nome da política de espelhamento de pacotes a desativar ou ativar.
• REGION: a região onde a política se encontra.

API

Para desativar ou ativar uma política de espelhamento de pacotes existente, faça um PATCH pedido ao métodopacketMirrorings.patch.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/packetMirrorings/POLICY_NAME
{
  "enable": "FALSE|TRUE"
}

Substitua o seguinte:

• PROJECT_ID: o ID do projeto onde a política está localizada.
• REGION: a região onde a política se encontra.
• POLICY_NAME: o nome da política de espelhamento de pacotes a desativar.

Consola

1. Na Google Cloud consola, aceda à página Packet Mirroring.

   Aceda à funcionalidade Packet Mirroring

2. Na lista de políticas de replicação de pacotes, selecione a que quer eliminar.

3. Clique em Eliminar.

4. Confirme clicando em Eliminar.

gcloud

Para eliminar uma política de espelhamento de pacotes, use o comando packet-mirrorings delete.

gcloud compute packet-mirrorings delete POLICY_NAME \
  --region=REGION \

Substitua o seguinte:

• POLICY_NAME: o nome da política de espelhamento de pacotes a eliminar.
• REGION: a região onde a política se encontra.

API

Para eliminar uma política de espelhamento de pacotes, faça um DELETE pedido ao método packetMirrorings.delete.

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/packetMirrorings/POLICY_NAME

Substitua o seguinte:

• PROJECT_ID: o ID do projeto onde a política está localizada.
• POLICY_NAME: o nome da política de espelhamento de pacotes a eliminar.
• REGION: a região onde a política se encontra.