Utilizza il bucket di un ambiente personalizzato

Cloud Composer 3 | Cloud Composer 2 | Cloud Composer 1

Quando crei un ambiente, puoi specificare un bucket Cloud Storage personalizzato come bucket dell'ambiente. Il tuo ambiente utilizza questo bucket come bucket dell'ambiente predefinito, ma il bucket dell'ambiente predefinito non viene creato.

Con un bucket personalizzato puoi:

  • Utilizza una configurazione del bucket conforme ai tuoi requisiti.
  • Utilizza un bucket esistente continuamente per scopi di sviluppo o test periodici.
  • Riutilizza un bucket esistente da un ambiente precedente e mantieni le integrazioni CI/CD e dei dati.
  • Elimina e ricrea un ambiente senza dover trasferire i dati tra i bucket.
  • Precompila il bucket personalizzato con i dati richiesti, ad esempio i file DAG, e poi crea un ambiente.

Prima di iniziare

  • Questa funzionalità è supportata a partire dalla versione 2.5.0 di Cloud Composer. Le versioni precedenti di Cloud Composer 2 non supportano questa funzionalità.
  • Il bucket personalizzato deve trovarsi nella stessa regione dell'ambiente. I bucket con più regioni e con due regioni non sono supportati.
  • Il bucket personalizzato e l'ambiente devono trovarsi nello stesso progetto.
  • Il bucket personalizzato deve avere la classe di archiviazione standard.
  • Al bucket personalizzato non devono essere applicati criteri di conservazione o blocchi dei criteri di conservazione.

  • Non è possibile utilizzare lo stesso bucket personalizzato con più ambienti contemporaneamente. Cloud Composer genera un errore se il bucket specificato è già utilizzato da un altro ambiente. È possibile eliminare un ambiente e utilizzare lo stesso bucket per un altro ambiente.

  • Se hai attivato il salvataggio dei log nel bucket dell'ambiente, se elimini un ambiente e utilizzi lo stesso bucket per un altro ambiente, il nuovo ambiente non mostra i log delle attività Airflow dell'ambiente precedente nell'interfaccia utente di Airflow. I log rimangono nel bucket, ma il nuovo ambiente non li associa a nessuna esecuzione di DAG.

  • Cloud Composer non aggiunge le autorizzazioni IAM mancanti al bucket Cloud Storage quando viene utilizzato per creare un ambiente. Assicurati che l'account di servizio dell'ambiente disponga delle autorizzazioni del ruolo Composer Worker sul bucket.

Creare un ambiente con un bucket personalizzato

Console

Per specificare un bucket Cloud Storage personalizzato quando crei un ambiente:

  1. Nella pagina Crea ambiente, fai clic su Mostra configurazione avanzata nella sezione Configurazione avanzata.
  2. Seleziona Bucket personalizzato.
  3. Nel campo Nome bucket, specifica o seleziona un bucket.

gcloud

Quando crei un ambiente, l'argomento --storage-bucket specifica il bucket personalizzato dell'ambiente.

gcloud composer environments create ENVIRONMENT_NAME \
    --location LOCATION \
    --storage-bucket CUSTOM_STORAGE_BUCKET

Sostituisci quanto segue:

  • ENVIRONMENT_NAME: il nome del tuo ambiente.
  • LOCATION: la regione in cui si trova l'ambiente.
  • CUSTOM_STORAGE_BUCKET: il nome di un bucket Cloud Storage. Puoi anche specificare l'URI del bucket (con il prefisso gs://).

Esempio:

gcloud composer environments create example-environment \
    --location us-cental1 \
    --storage-bucket us-central1-example-bucket

API

Quando crei un ambiente, nella risorsa Environment > StorageConfig, specifica un bucket personalizzato per l'ambiente.

{
  "name": "projects/PROJECT_ID/locations/LOCATION/environments/ENVIRONMENT_NAME",
  "storageConfig": {
    "bucket": "CUSTOM_STORAGE_BUCKET"
  }
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto.
  • LOCATION: la regione in cui si trova l'ambiente.
  • ENVIRONMENT_NAME: il nome del tuo ambiente.
  • CUSTOM_STORAGE_BUCKET: il nome di un bucket Cloud Storage (senza il prefisso gs://).

Esempio:

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

{
  "name": "projects/example-project/locations/us-central1/environments/example-environment",
  "storageConfig": {
    "bucket": "us-central1-example-bucket"
  }
}

Terraform

Quando crei un ambiente, il campo bucket nel blocco storage_config specifica il bucket personalizzato dell'ambiente.

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

  storage_config {

    bucket = CUSTOM_STORAGE_BUCKET

  }
}

Sostituisci quanto segue:

  • ENVIRONMENT_NAME: il nome del tuo ambiente.
  • LOCATION: la regione in cui si trova l'ambiente.
  • CUSTOM_STORAGE_BUCKET: il nome di un bucket Cloud Storage. Puoi anche specificare l'URI del bucket (con il prefisso gs://).

Esempio:

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

  storage_config {

    bucket = "gs://us-central1-example-bucket"

  }
}

Passaggi successivi