Configurazione di intervalli IP pubblici utilizzati privatamente

Cloud Composer 3 | Cloud Composer 2 | Cloud Composer 1

Questa pagina spiega come utilizzare gli intervalli di IP pubblici utilizzati privatamente nel tuo ambiente IP privato. Per informazioni generali sulla creazione di ambienti IP privati, consulta Configurare un ambiente IP privato.

Informazioni sugli intervalli IP pubblici utilizzati privatamente in Cloud Composer

Google Kubernetes Engine richiede molti indirizzi IP per le sue risorse: ogni nodo, pod e servizio deve avere un indirizzo IP univoco. Ciò può portare a una situazione in cui gli intervalli IP privati esistenti non possono contenere un numero sufficiente di indirizzi IP.

Gli ambienti Cloud Composer possono utilizzare alcuni intervalli IP dello spazio di indirizzi non RFC 1918 senza configurazione aggiuntiva.

Se vuoi utilizzare più indirizzi IP, il tuo ambiente può utilizzare privatamente alcuni intervalli di indirizzi IP pubblici come intervalli di indirizzi IP di subnet interni per pod e servizi. Questi intervalli sono chiamati intervalli IP pubblici utilizzati privatamente (PUPI).

Puoi utilizzare privatamente qualsiasi indirizzo IP pubblico, ad eccezione di determinati intervalli con limitazioni.

Prima di iniziare

  • Puoi specificare intervalli IP pubblici solo quando crei un nuovo ambiente. Non è possibile modificare gli intervalli IP di un ambiente esistente.

  • L'ambiente deve essere un ambiente IP privato.

  • Puoi creare ambienti con intervalli PUPI solo utilizzando gcloud, Terraform e l'API REST.

  • Solo i pod e i servizi GKE possono utilizzare intervalli IP pubblici. Altri componenti dell'ambiente, come Cloud SQL, il server web e il piano di controllo GKE, non possono utilizzare intervalli IP pubblici in un ambiente IP privato.

  • Il cluster GKE viene creato con il SNAT predefinito disattivato.

Attivare gli intervalli PUPI quando crei un ambiente

gcloud

Per creare un ambiente con intervalli PUPI, utilizza l'argomento --enable-privately-used-public-ips quando crei un ambiente IP privato. Quindi, specifica gli intervalli IP pubblici per i pod e i servizi.

Intervalli di sottoreti gestiti da GKE

Per creare intervalli di subnet gestiti da GKE:

gcloud composer environments create ENVIRONMENT_NAME \
    --location LOCATION \
    --image-version composer-2.11.1-airflow-2.10.2 \
    --enable-private-environment \
    --enable-privately-used-public-ips \
    --cluster-ipv4-cidr POD_IP_RANGE \
    --services-ipv4-cidr SERVICES_IP_RANGE

Sostituisci:

  • ENVIRONMENT_NAME con il nome dell'ambiente.
  • LOCATION con la regione in cui si trova l'ambiente.
  • POD_IP_RANGE con un intervallo di indirizzi IP in notazione CIDR. Questo intervallo viene aggiunto come intervallo di indirizzi IP secondario alla subnet del tuo ambiente e viene utilizzato come intervallo di indirizzi IP per i pod.
  • SERVICES_IP_RANGE con un intervallo di indirizzi IP in notazione CIDR. Questo intervallo è l'intervallo di indirizzi IP secondario per i servizi nella subnet del tuo ambiente.

Esempio:

gcloud composer environments create example-environment \
    --location us-central1 \
    --image-version composer-2.11.1-airflow-2.10.2 \
    --enable-private-environment \
    --enable-privately-used-public-ips \
    --cluster-ipv4-cidr 10.3.192.0/20 \
    --services-ipv4-cidr 172.16.194.0/23

Intervalli di subnet gestiti dall'utente

Per creare intervalli gestiti dall'utente:

gcloud composer environments create ENVIRONMENT_NAME \
    --location LOCATION \
    --image-version composer-2.11.1-airflow-2.10.2 \
    --enable-private-environment \
    --enable-privately-used-public-ips \
    --cluster-secondary-range-name POD_IP_RANGE_NAME \
    --services-secondary-range-name SERVICES_IP_RANGE_NAME

Sostituisci:

  • ENVIRONMENT_NAME con il nome dell'ambiente.
  • LOCATION con la regione in cui si trova l'ambiente.
  • POD_IP_RANGE_NAME con il nome di un intervallo di indirizzi IP secondario esistente nella subnet specificata. Questo intervallo viene utilizzato dai pod.
  • SERVICES_IP_RANGE_NAME con il nome di un intervallo di indirizzi IP secondario esistente nella subnet specificata. Questo intervallo viene utilizzato dai servizi.

Esempio:

gcloud composer environments create example-environment \
    --location us-central1 \
    --image-version composer-2.11.1-airflow-2.10.2 \
    --enable-private-environment \
    --enable-privately-used-public-ips \
    --cluster-secondary-range-name "public-1" \
    --services-secondary-range-name "public-2"

API

Costruisci una richiesta API environments.create. Nella risorsa Environment, specifica i parametri di configurazione per un ambiente con intervalli PUPI.

Intervalli di sottoreti gestiti da GKE

Per creare intervalli di subnet gestiti da GKE:

// POST https://composer.googleapis.com/v1/{parent=projects/*/locations/*}/environments

{
  "name": "ENVIRONMENT_NAME",
  "config": {
    "nodeConfig": {
      "ipAllocationPolicy": {
        "clusterIpv4CidrBlock":"POD_IP_RANGE",
        "servicesIpv4CidrBlock":"SERVICES_IP_RANGE"
      }
    },
    "privateEnvironmentConfig": {
      "enablePrivateEnvironment": true,
      "enablePrivatelyUsedPublicIps": true
    }
  }
}

Sostituisci:

  • ENVIRONMENT_NAME con il nome dell'ambiente.
  • POD_IP_RANGE con un intervallo di indirizzi IP in notazione CIDR. Questo intervallo viene aggiunto come intervallo di indirizzi IP secondario alla subnet del tuo ambiente e viene utilizzato come intervallo di indirizzi IP per i pod.
  • SERVICES_IP_RANGE con un intervallo di indirizzi IP in notazione CIDR. Questo intervallo è l'intervallo di indirizzi IP secondario per i servizi nella subnet del tuo ambiente.

Esempio:

// POST https://composer.googleapis.com/v1/{parent=projects/*/locations/*}/environments

{
  "name": "example-environment",
  "config": {
    "nodeConfig": {
      "ipAllocationPolicy": {
        "clusterIpv4CidrBlock":"10.3.192.0/20",
        "servicesIpv4CidrBlock":"172.16.194.0/23"
      }
    },
    "privateEnvironmentConfig": {
      "enablePrivateEnvironment": true,
      "enablePrivatelyUsedPublicIps": true
    }
  }
}

Intervalli di subnet gestiti dall'utente

Per creare intervalli gestiti dall'utente:

// POST https://composer.googleapis.com/v1/{parent=projects/*/locations/*}/environments

{
  "name": "ENVIRONMENT_NAME",
  "config": {
    "nodeConfig": {
      "ipAllocationPolicy": {
        "clusterSecondaryRangeName":"POD_IP_RANGE",
        "servicesSecondaryRangeName": "SERVICES_IP_RANGE"
      }
    },
    "privateEnvironmentConfig": {
      "enablePrivateEnvironment": true,
      "enablePrivatelyUsedPublicIps": true
    }
  }
}

Sostituisci:

  • ENVIRONMENT_NAME con il nome dell'ambiente.
  • POD_IP_RANGE_NAME con il nome di un intervallo di indirizzi IP secondario esistente nella subnet specificata. Questo intervallo viene utilizzato dai pod.
  • SERVICES_IP_RANGE_NAME con il nome di un intervallo di indirizzi IP secondario esistente nella subnet specificata. Questo intervallo viene utilizzato dai servizi.

Esempio:

// POST https://composer.googleapis.com/v1/{parent=projects/*/locations/*}/environments

{
  "name": "example-environment",
  "config": {
    "nodeConfig": {
      "ipAllocationPolicy": {
        "clusterSecondaryRangeName":"public-1",
        "servicesSecondaryRangeName": "public-2"
      }
    },
    "privateEnvironmentConfig": {
      "enablePrivateEnvironment": true,
      "enablePrivatelyUsedPublicIps": true
    }
  }
}

Terraform

Quando crei un ambiente, il campo enable_privately_used_public_ips nel blocco private_environment_config consente l'utilizzo degli intervalli PUPI. Devi anche specificare gli intervalli PUPI per i pod e i servizi.

Intervalli di sottoreti gestiti da GKE

Per creare intervalli di subnet gestiti da GKE:

resource "google_composer_environment" "example_environment" {
  provider = google-beta
  name = "ENVIRONMENT_NAME"
  region = "LOCATION"

  config {

    node_config {

      ip_allocation_policy = [{
        
        cluster_ipv4_cidr_block = "POD_IP_RANGE"
        services_ipv4_cidr_block = "SERVICES_IP_RANGE"
        cluster_secondary_range_name = null
        services_secondary_range_name = null
      }]
    }

    private_environment_config {
      enable_privately_used_public_ips = true
      // Other private ip environment parameters
    }

  }
}

Sostituisci:

  • ENVIRONMENT_NAME con il nome dell'ambiente.
  • LOCATION con la regione in cui si trova l'ambiente.
  • POD_IP_RANGE con un intervallo di indirizzi IP in notazione CIDR. Questo intervallo viene aggiunto come intervallo di indirizzi IP secondario alla subnet del tuo ambiente e viene utilizzato come intervallo di indirizzi IP per i pod.
  • SERVICES_IP_RANGE con un intervallo di indirizzi IP in notazione CIDR. Questo intervallo è l'intervallo di indirizzi IP secondario per i servizi nella subnet del tuo ambiente.

Esempio:

resource "google_composer_environment" "example_environment" {
  provider = google-beta
  name = "example-environment"
  region = "us-central1"

  config {

    node_config {

      // Specify your network and subnetwork
      network    = google_compute_network.example_network.id
      subnetwork = google_compute_subnetwork.example_subnet.id

      ip_allocation_policy = [{
        
        // Specify PUPI addresses
        cluster_ipv4_cidr_block = "10.3.192.0/20"
        services_ipv4_cidr_block = "172.16.194.0/23"
        cluster_secondary_range_name = null
        services_secondary_range_name = null
      }]
    }

    private_environment_config {
      enable_privately_used_public_ips = true
      // Other private environment parameters
    }

  }
}

Intervalli di subnet gestiti dall'utente

Per creare intervalli gestiti dall'utente:

resource "google_composer_environment" "example_environment" {
  provider = google-beta
  name = "ENVIRONMENT_NAME"
  region = "LOCATION"

  config {

    node_config {

      ip_allocation_policy = [{
        
        cluster_ipv4_cidr_block = null
        services_ipv4_cidr_block = null
        cluster_secondary_range_name = POD_IP_RANGE_NAME
        services_secondary_range_name = SERVICES_IP_RANGE_NAME
      }]
    }

    private_environment_config {
      enable_privately_used_public_ips = true
      // Other private ip environment parameters
    }

  }

Sostituisci:

  • ENVIRONMENT_NAME con il nome dell'ambiente.
  • LOCATION con la regione in cui si trova l'ambiente.
  • POD_IP_RANGE_NAME con il nome di un intervallo di indirizzi IP secondario esistente nella subnet specificata. Questo intervallo viene utilizzato dai pod.
  • SERVICES_IP_RANGE_NAME con il nome di un intervallo di indirizzi IP secondario esistente nella subnet specificata. Questo intervallo viene utilizzato dai servizi.

Esempio:

resource "google_composer_environment" "example_environment" {
  provider = google-beta
  name = "example-environment"
  region = "us-central1"

  config {

    node_config {

      // Specify your network and subnetwork
      network    = google_compute_network.example_network.id
      subnetwork = google_compute_subnetwork.example_subnet.id

      ip_allocation_policy = [{
        
        cluster_ipv4_cidr_block = null
        services_ipv4_cidr_block = null
        // Specify existing ranges
        cluster_secondary_range_name = "public-1"
        services_secondary_range_name = "public-2"
      }]
    }
    private_environment_config {
      enable_privately_used_public_ips = true
      // Other private environment parameters
    }

  }
}

Passaggi successivi