Endereço IP de saída estático

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

gcloud

1. Crie um novo Cloud Router para programar um gateway da Cloud NAT:

   gcloud compute routers create ROUTER_NAME \
     --network=NETWORK_NAME \
     --region=REGION

   Substitua os seguintes valores neste comando:

   • ROUTER_NAME com um nome para o recurso do Cloud Router que você quer criar.
   • NETWORK_NAME pelo nome da rede VPC que você encontrou anteriormente.
   • REGION pela região em que você quer criar um gateway do Cloud NAT.

2. Reservar um endereço IP estático Um recurso de endereço IP reservado retém o endereço IP subjacente quando o recurso ao qual ele está associado é excluído e recriado:

   gcloud compute addresses create ORIGIN_IP_NAME --region=REGION

   Substitua os seguintes valores neste comando:

   • ORIGIN_IP_NAME pelo nome que você quer atribuir ao recurso de endereço IP.
   • REGION pela região que executará o roteador do Cloud NAT. Use a mesma região do serviço do Cloud Run para minimizar os custos de latência e rede.

3. Crie uma configuração de gateway do Cloud NAT neste roteador para rotear o tráfego proveniente da rede VPC usando o endereço IP estático que você criou:

   gcloud compute routers nats create NAT_NAME \
     --router=ROUTER_NAME \
     --region=REGION \
     --nat-custom-subnet-ip-ranges=SUBNET_NAME \
     --nat-external-ip-pool=ORIGIN_IP_NAME

   Substitua os seguintes valores neste comando:

   • NAT_NAME com um nome para o recurso de gateway do Cloud NAT que você quer criar.
   • ROUTER_NAME com o nome do seu Cloud Router
   • REGION pela região em que você quer criar um gateway do Cloud NAT.
   • SUBNET_NAME pelo nome da sub-rede.
   • ORIGIN_IP_NAME pelo nome do recurso de endereço IP reservado criado na etapa anterior.

Terraform

1. Crie um novo Cloud Router para programar um gateway da Cloud NAT:

   resource "google_compute_router" "default" {
     name    = "cr-static-ip-router"
     network = google_compute_network.default.name
     region  = google_compute_subnetwork.default.region
   }

   Substitua cr-static-ip-router pelo nome da sua sub-rede.

2. Reservar um endereço IP estático Um recurso de endereço IP reservado retém o endereço IP subjacente quando o recurso ao qual ele está associado é excluído e recriado:

   resource "google_compute_address" "default" {
     name   = "cr-static-ip-addr"
     region = google_compute_subnetwork.default.region
   }

   Substitua cr-static-ip-addr pelo nome da sua sub-rede.

3. Crie uma configuração de gateway do Cloud NAT neste roteador para rotear o tráfego proveniente da rede VPC usando o endereço IP estático que você criou:

   resource "google_compute_router_nat" "default" {
     name   = "cr-static-nat"
     router = google_compute_router.default.name
     region = google_compute_subnetwork.default.region
   
     nat_ip_allocate_option = "MANUAL_ONLY"
     nat_ips                = [google_compute_address.default.self_link]
   
     source_subnetwork_ip_ranges_to_nat = "LIST_OF_SUBNETWORKS"
     subnetwork {
       name                    = google_compute_subnetwork.default.id
       source_ip_ranges_to_nat = ["ALL_IP_RANGES"]
     }
   }

   Substitua cr-static-nat pelo nome do gateway NAT do Cloud.

gcloud

Saída de VPC direta

Para implantar ou atualizar o serviço do Cloud Run para usar a saída VPC direta e rotear todo o tráfego de saída por ela, execute o seguinte comando:

gcloud run deploy SERVICE_NAME 

    --image=IMAGE_URL 

    --network=NETWORK 

    --subnet=SUBNET 

    --region=REGION 

    --vpc-egress=all-traffic

Substitua os seguintes valores neste comando:

• SERVICE_NAME pelo nome do serviço do Cloud Run que você quer implantar.
• IMAGE_URL por uma referência à imagem de contêiner. Por exemplo, us-docker.pkg.dev/cloudrun/container/hello:latest. Se você usa o Artifact Registry, o repositório REPO_NAME já precisará ter sido criado. O URL tem o formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
• NETWORK pelo nome da sua rede VPC;
• SUBNET pelo nome da sub-rede.
• REGION por uma região do seu serviço.

Conector de acesso VPC sem servidor

Para implantar ou atualizar seu serviço do Cloud Run para usar um conector de acesso VPC sem servidor e rotear todo o tráfego de saída por ele, execute o seguinte comando:

gcloud run deploy SERVICE_NAME 

    --image=IMAGE_URL 

    --vpc-connector=CONNECTOR_NAME 

    --region=REGION 

    --vpc-egress=all-traffic

Substitua os seguintes valores neste comando: * SERVICE_NAME pelo nome do serviço do Cloud Run que você quer implantar. * IMAGE_URL por uma referência à imagem do contêiner. Por exemplo, us-docker.pkg.dev/cloudrun/container/hello:latest. Se você usa o Artifact Registry, o repositório REPO_NAME já precisa ter sido criado. O URL tem o formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG . * CONNECTOR_NAME pelo nome do conector de acesso VPC sem servidor. * REGION por uma região do seu serviço.

YAML

Saída de VPC direta

1. Se você estiver criando um novo serviço, pule esta etapa. Se você estiver atualizando um serviço, faça o download da configuração YAML correspondente:

   gcloud run services describe SERVICE --format export > service.yaml

2. Faça as atualizações necessárias.

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       metadata:
         annotations:
           run.googleapis.com/network-interfaces: '[{"network":"NETWORK","subnetwork":"SUBNET"}]'
           run.googleapis.com/vpc-access-egress: all-traffic
       spec:
         containers:
         - image: IMAGE_URL

   Substitua:

   • SERVICE pelo nome do serviço do Cloud Run.
   • NETWORK pelo nome da sua rede VPC;
   • SUBNET pelo nome da sub-rede.
   • IMAGE_URL pelo URL da imagem de contêiner do serviço.

3. Crie ou atualize o serviço usando o seguinte comando:

   gcloud run services replace service.yaml

Conector de acesso VPC sem servidor

1. Se você estiver criando um novo serviço, pule esta etapa. Se você estiver atualizando um serviço, faça o download da configuração YAML correspondente:

   gcloud run services describe SERVICE --format export > service.yaml

2. Faça as atualizações necessárias.

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       metadata:
         annotations:
           run.googleapis.com/vpc-access-connector: CONNECTOR_NAME
       spec:
         containers:
         - image: IMAGE_URL

   Substitua:

   • SERVICE pelo nome do serviço do Cloud Run.
   • CONNECTOR_NAME pelo nome da sua rede de acesso VPC sem servidor.
   • IMAGE_URL pelo URL da imagem de contêiner do serviço.

3. Crie ou atualize o serviço usando o seguinte comando:

   gcloud run services replace service.yaml

Terraform

Esse serviço do Cloud Run usa um conector VPC e encaminha todo o tráfego de saída por ele:

resource "google_cloud_run_v2_service" "default" {
  name     = "cr-static-ip-service"
  location = google_compute_subnetwork.default.region

  deletion_protection = false # set to "true" in production

  template {
    containers {
      # Replace with the URL of your container
      #   gcr.io/<YOUR_GCP_PROJECT_ID>/<YOUR_CONTAINER_NAME>
      image = "us-docker.pkg.dev/cloudrun/container/hello"
    }
    scaling {
      max_instance_count = 5
    }
    vpc_access {
      connector = google_vpc_access_connector.default.id
      egress    = "ALL_TRAFFIC"
    }
  }
  ingress = "INGRESS_TRAFFIC_ALL"

}

Substitua us-docker.pkg.dev/cloudrun/container/hello por uma referência à imagem do seu contêiner.