Environment
An environment for running orchestration tasks.
Environments run Apache Airflow software on Google infrastructure.
To get more information about Environments, see:
- API documentation
- How-to Guides
- Apache Airflow Documentation
Warning: We STRONGLY recommend you read the GCP guides as the Environment resource requires a long deployment process and involves several layers of GCP infrastructure, including a Kubernetes Engine cluster, Cloud Storage, and Compute networking resources. Due to limitations of the API, This provider will not be able to automatically find or manage many of these underlying resources. In particular: * It can take up to one hour to create or update an environment resource. In addition, GCP may only detect some errors in configuration when they are used (e.g. ~40-50 minutes into the creation process), and is prone to limited error reporting. If you encounter confusing or uninformative errors, please verify your configuration is valid against GCP Cloud Composer before filing bugs against this provider. * Environments create Google Cloud Storage buckets that do not get cleaned up automatically on environment deletion. More about Composer’s use of Cloud Storage.
Create a Environment Resource
new Environment(name: string, args?: EnvironmentArgs, opts?: CustomResourceOptions);def Environment(resource_name, opts=None, config=None, labels=None, name=None, project=None, region=None, __props__=None);func NewEnvironment(ctx *Context, name string, args *EnvironmentArgs, opts ...ResourceOption) (*Environment, error)public Environment(string name, EnvironmentArgs? args = null, CustomResourceOptions? opts = null)- name string
- The unique name of the resource.
- args EnvironmentArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- opts ResourceOptions
- A bag of options that control this resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args EnvironmentArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args EnvironmentArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
Environment Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Programming Model docs.
Inputs
The Environment resource accepts the following input properties:
- Config
Environment
Config Args Configuration parameters for this environment Structure is documented below.
- Labels Dictionary<string, string>
User-defined labels for this environment. The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions: Label keys must be between 1 and 63 characters long and must conform to the following regular expression:
a-z?. Label values must be between 0 and 63 characters long and must conform to the regular expression(a-z?)?. No more than 64 labels can be associated with a given environment. Both keys and values must be <= 128 bytes in size.- Name string
Name of the environment
- Project string
The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Region string
The location or Compute Engine region for the environment.
- Config
Environment
Config Configuration parameters for this environment Structure is documented below.
- Labels map[string]string
User-defined labels for this environment. The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions: Label keys must be between 1 and 63 characters long and must conform to the following regular expression:
a-z?. Label values must be between 0 and 63 characters long and must conform to the regular expression(a-z?)?. No more than 64 labels can be associated with a given environment. Both keys and values must be <= 128 bytes in size.- Name string
Name of the environment
- Project string
The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Region string
The location or Compute Engine region for the environment.
- config
Environment
Config Configuration parameters for this environment Structure is documented below.
- labels {[key: string]: string}
User-defined labels for this environment. The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions: Label keys must be between 1 and 63 characters long and must conform to the following regular expression:
a-z?. Label values must be between 0 and 63 characters long and must conform to the regular expression(a-z?)?. No more than 64 labels can be associated with a given environment. Both keys and values must be <= 128 bytes in size.- name string
Name of the environment
- project string
The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region string
The location or Compute Engine region for the environment.
- config
Dict[Environment
Config] Configuration parameters for this environment Structure is documented below.
- labels Dict[str, str]
User-defined labels for this environment. The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions: Label keys must be between 1 and 63 characters long and must conform to the following regular expression:
a-z?. Label values must be between 0 and 63 characters long and must conform to the regular expression(a-z?)?. No more than 64 labels can be associated with a given environment. Both keys and values must be <= 128 bytes in size.- name str
Name of the environment
- project str
The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region str
The location or Compute Engine region for the environment.
Outputs
All input properties are implicitly available as output properties. Additionally, the Environment resource produces the following output properties:
Look up an Existing Environment Resource
Get an existing Environment resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: EnvironmentState, opts?: CustomResourceOptions): Environmentstatic get(resource_name, id, opts=None, config=None, labels=None, name=None, project=None, region=None, __props__=None);func GetEnvironment(ctx *Context, name string, id IDInput, state *EnvironmentState, opts ...ResourceOption) (*Environment, error)public static Environment Get(string name, Input<string> id, EnvironmentState? state, CustomResourceOptions? opts = null)- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
The following state arguments are supported:
- Config
Environment
Config Args Configuration parameters for this environment Structure is documented below.
- Labels Dictionary<string, string>
User-defined labels for this environment. The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions: Label keys must be between 1 and 63 characters long and must conform to the following regular expression:
a-z?. Label values must be between 0 and 63 characters long and must conform to the regular expression(a-z?)?. No more than 64 labels can be associated with a given environment. Both keys and values must be <= 128 bytes in size.- Name string
Name of the environment
- Project string
The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Region string
The location or Compute Engine region for the environment.
- Config
Environment
Config Configuration parameters for this environment Structure is documented below.
- Labels map[string]string
User-defined labels for this environment. The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions: Label keys must be between 1 and 63 characters long and must conform to the following regular expression:
a-z?. Label values must be between 0 and 63 characters long and must conform to the regular expression(a-z?)?. No more than 64 labels can be associated with a given environment. Both keys and values must be <= 128 bytes in size.- Name string
Name of the environment
- Project string
The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Region string
The location or Compute Engine region for the environment.
- config
Environment
Config Configuration parameters for this environment Structure is documented below.
- labels {[key: string]: string}
User-defined labels for this environment. The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions: Label keys must be between 1 and 63 characters long and must conform to the following regular expression:
a-z?. Label values must be between 0 and 63 characters long and must conform to the regular expression(a-z?)?. No more than 64 labels can be associated with a given environment. Both keys and values must be <= 128 bytes in size.- name string
Name of the environment
- project string
The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region string
The location or Compute Engine region for the environment.
- config
Dict[Environment
Config] Configuration parameters for this environment Structure is documented below.
- labels Dict[str, str]
User-defined labels for this environment. The labels map can contain no more than 64 entries. Entries of the labels map are UTF8 strings that comply with the following restrictions: Label keys must be between 1 and 63 characters long and must conform to the following regular expression:
a-z?. Label values must be between 0 and 63 characters long and must conform to the regular expression(a-z?)?. No more than 64 labels can be associated with a given environment. Both keys and values must be <= 128 bytes in size.- name str
Name of the environment
- project str
The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region str
The location or Compute Engine region for the environment.
Supporting Types
EnvironmentConfig
- Airflow
Uri string - Dag
Gcs stringPrefix - Gke
Cluster string - Node
Config EnvironmentConfig Node Config Args The configuration used for the Kubernetes Engine cluster. Structure is documented below.
- Node
Count int The number of nodes in the Kubernetes Engine cluster that will be used to run this environment.
- Private
Environment EnvironmentConfig Config Private Environment Config Args The configuration used for the Private IP Cloud Composer environment. Structure is documented below.
- Software
Config EnvironmentConfig Software Config Args The configuration settings for software inside the environment. Structure is documented below.
- Web
Server EnvironmentNetwork Access Control Config Web Server Network Access Control Args The network-level access control policy for the Airflow web server. If unspecified, no network-level access restrictions will be applied.
- Airflow
Uri string - Dag
Gcs stringPrefix - Gke
Cluster string - Node
Config EnvironmentConfig Node Config The configuration used for the Kubernetes Engine cluster. Structure is documented below.
- Node
Count int The number of nodes in the Kubernetes Engine cluster that will be used to run this environment.
- Private
Environment EnvironmentConfig Config Private Environment Config The configuration used for the Private IP Cloud Composer environment. Structure is documented below.
- Software
Config EnvironmentConfig Software Config The configuration settings for software inside the environment. Structure is documented below.
- Web
Server EnvironmentNetwork Access Control Config Web Server Network Access Control The network-level access control policy for the Airflow web server. If unspecified, no network-level access restrictions will be applied.
- airflow
Uri string - dag
Gcs stringPrefix - gke
Cluster string - node
Config EnvironmentConfig Node Config The configuration used for the Kubernetes Engine cluster. Structure is documented below.
- node
Count number The number of nodes in the Kubernetes Engine cluster that will be used to run this environment.
- private
Environment EnvironmentConfig Config Private Environment Config The configuration used for the Private IP Cloud Composer environment. Structure is documented below.
- software
Config EnvironmentConfig Software Config The configuration settings for software inside the environment. Structure is documented below.
- web
Server EnvironmentNetwork Access Control Config Web Server Network Access Control The network-level access control policy for the Airflow web server. If unspecified, no network-level access restrictions will be applied.
- airflow
Uri str - dag
Gcs strPrefix - gke
Cluster str - node_
config Dict[EnvironmentConfig Node Config] The configuration used for the Kubernetes Engine cluster. Structure is documented below.
- node_
count float The number of nodes in the Kubernetes Engine cluster that will be used to run this environment.
- private
Environment Dict[EnvironmentConfig Config Private Environment Config] The configuration used for the Private IP Cloud Composer environment. Structure is documented below.
- software
Config Dict[EnvironmentConfig Software Config] The configuration settings for software inside the environment. Structure is documented below.
- web
Server Dict[EnvironmentNetwork Access Control Config Web Server Network Access Control] The network-level access control policy for the Airflow web server. If unspecified, no network-level access restrictions will be applied.
EnvironmentConfigNodeConfig
- Zone string
The Compute Engine zone in which to deploy the VMs running the Apache Airflow software, specified as the zone name or relative resource name (e.g. “projects/{project}/zones/{zone}”). Must belong to the enclosing environment’s project and region.
- Disk
Size intGb The disk size in GB used for node VMs. Minimum size is 20GB. If unspecified, defaults to 100GB. Cannot be updated.
- Ip
Allocation EnvironmentPolicy Config Node Config Ip Allocation Policy Args Configuration for controlling how IPs are allocated in the GKE cluster. Structure is documented below. Cannot be updated.
- Machine
Type string The Compute Engine machine type used for cluster instances, specified as a name or relative resource name. For example: “projects/{project}/zones/{zone}/machineTypes/{machineType}”. Must belong to the enclosing environment’s project and region/zone.
- Network string
The Compute Engine network to be used for machine communications, specified as a self-link, relative resource name (e.g. “projects/{project}/global/networks/{network}”), by name.
- Oauth
Scopes List<string> The set of Google API scopes to be made available on all node VMs. Cannot be updated. If empty, defaults to
["https://www.googleapis.com/auth/cloud-platform"]- Service
Account string The Google Cloud Platform Service Account to be used by the node VMs. If a service account is not specified, the “default” Compute Engine service account is used. Cannot be updated. If given, note that the service account must have
roles/composer.workerfor any GCP resources created under the Cloud Composer Environment.- Subnetwork string
The Compute Engine subnetwork to be used for machine communications, , specified as a self-link, relative resource name (e.g. “projects/{project}/regions/{region}/subnetworks/{subnetwork}”), or by name. If subnetwork is provided, network must also be provided and the subnetwork must belong to the enclosing environment’s project and region.
- List<string>
The list of instance tags applied to all node VMs. Tags are used to identify valid sources or targets for network firewalls. Each tag within the list must comply with RFC1035. Cannot be updated.
- Zone string
The Compute Engine zone in which to deploy the VMs running the Apache Airflow software, specified as the zone name or relative resource name (e.g. “projects/{project}/zones/{zone}”). Must belong to the enclosing environment’s project and region.
- Disk
Size intGb The disk size in GB used for node VMs. Minimum size is 20GB. If unspecified, defaults to 100GB. Cannot be updated.
- Ip
Allocation EnvironmentPolicy Config Node Config Ip Allocation Policy Configuration for controlling how IPs are allocated in the GKE cluster. Structure is documented below. Cannot be updated.
- Machine
Type string The Compute Engine machine type used for cluster instances, specified as a name or relative resource name. For example: “projects/{project}/zones/{zone}/machineTypes/{machineType}”. Must belong to the enclosing environment’s project and region/zone.
- Network string
The Compute Engine network to be used for machine communications, specified as a self-link, relative resource name (e.g. “projects/{project}/global/networks/{network}”), by name.
- Oauth
Scopes []string The set of Google API scopes to be made available on all node VMs. Cannot be updated. If empty, defaults to
["https://www.googleapis.com/auth/cloud-platform"]- Service
Account string The Google Cloud Platform Service Account to be used by the node VMs. If a service account is not specified, the “default” Compute Engine service account is used. Cannot be updated. If given, note that the service account must have
roles/composer.workerfor any GCP resources created under the Cloud Composer Environment.- Subnetwork string
The Compute Engine subnetwork to be used for machine communications, , specified as a self-link, relative resource name (e.g. “projects/{project}/regions/{region}/subnetworks/{subnetwork}”), or by name. If subnetwork is provided, network must also be provided and the subnetwork must belong to the enclosing environment’s project and region.
- []string
The list of instance tags applied to all node VMs. Tags are used to identify valid sources or targets for network firewalls. Each tag within the list must comply with RFC1035. Cannot be updated.
- zone string
The Compute Engine zone in which to deploy the VMs running the Apache Airflow software, specified as the zone name or relative resource name (e.g. “projects/{project}/zones/{zone}”). Must belong to the enclosing environment’s project and region.
- disk
Size numberGb The disk size in GB used for node VMs. Minimum size is 20GB. If unspecified, defaults to 100GB. Cannot be updated.
- ip
Allocation EnvironmentPolicy Config Node Config Ip Allocation Policy Configuration for controlling how IPs are allocated in the GKE cluster. Structure is documented below. Cannot be updated.
- machine
Type string The Compute Engine machine type used for cluster instances, specified as a name or relative resource name. For example: “projects/{project}/zones/{zone}/machineTypes/{machineType}”. Must belong to the enclosing environment’s project and region/zone.
- network string
The Compute Engine network to be used for machine communications, specified as a self-link, relative resource name (e.g. “projects/{project}/global/networks/{network}”), by name.
- oauth
Scopes string[] The set of Google API scopes to be made available on all node VMs. Cannot be updated. If empty, defaults to
["https://www.googleapis.com/auth/cloud-platform"]- service
Account string The Google Cloud Platform Service Account to be used by the node VMs. If a service account is not specified, the “default” Compute Engine service account is used. Cannot be updated. If given, note that the service account must have
roles/composer.workerfor any GCP resources created under the Cloud Composer Environment.- subnetwork string
The Compute Engine subnetwork to be used for machine communications, , specified as a self-link, relative resource name (e.g. “projects/{project}/regions/{region}/subnetworks/{subnetwork}”), or by name. If subnetwork is provided, network must also be provided and the subnetwork must belong to the enclosing environment’s project and region.
- string[]
The list of instance tags applied to all node VMs. Tags are used to identify valid sources or targets for network firewalls. Each tag within the list must comply with RFC1035. Cannot be updated.
- zone str
The Compute Engine zone in which to deploy the VMs running the Apache Airflow software, specified as the zone name or relative resource name (e.g. “projects/{project}/zones/{zone}”). Must belong to the enclosing environment’s project and region.
- disk_
size_ floatgb The disk size in GB used for node VMs. Minimum size is 20GB. If unspecified, defaults to 100GB. Cannot be updated.
- ip_
allocation_ Dict[Environmentpolicy Config Node Config Ip Allocation Policy] Configuration for controlling how IPs are allocated in the GKE cluster. Structure is documented below. Cannot be updated.
- machine_
type str The Compute Engine machine type used for cluster instances, specified as a name or relative resource name. For example: “projects/{project}/zones/{zone}/machineTypes/{machineType}”. Must belong to the enclosing environment’s project and region/zone.
- network str
The Compute Engine network to be used for machine communications, specified as a self-link, relative resource name (e.g. “projects/{project}/global/networks/{network}”), by name.
- oauth
Scopes List[str] The set of Google API scopes to be made available on all node VMs. Cannot be updated. If empty, defaults to
["https://www.googleapis.com/auth/cloud-platform"]- service_
account str The Google Cloud Platform Service Account to be used by the node VMs. If a service account is not specified, the “default” Compute Engine service account is used. Cannot be updated. If given, note that the service account must have
roles/composer.workerfor any GCP resources created under the Cloud Composer Environment.- subnetwork str
The Compute Engine subnetwork to be used for machine communications, , specified as a self-link, relative resource name (e.g. “projects/{project}/regions/{region}/subnetworks/{subnetwork}”), or by name. If subnetwork is provided, network must also be provided and the subnetwork must belong to the enclosing environment’s project and region.
- List[str]
The list of instance tags applied to all node VMs. Tags are used to identify valid sources or targets for network firewalls. Each tag within the list must comply with RFC1035. Cannot be updated.
EnvironmentConfigNodeConfigIpAllocationPolicy
- Use
Ip boolAliases Whether or not to enable Alias IPs in the GKE cluster. If true, a VPC-native cluster is created. Defaults to true if the
ip_allocation_blockis present in config.- Cluster
Ipv4Cidr stringBlock The IP address range used to allocate IP addresses to pods in the cluster. Set to blank to have GKE choose a range with the default size. Set to /netmask (e.g. /14) to have GKE choose a range with a specific netmask. Set to a CIDR notation (e.g. 10.96.0.0/14) from the RFC-1918 private networks (e.g. 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16) to pick a specific range to use. Specify either
cluster_secondary_range_nameorcluster_ipv4_cidr_blockbut not both.- Cluster
Secondary stringRange Name The name of the cluster’s secondary range used to allocate IP addresses to pods. Specify either
cluster_secondary_range_nameorcluster_ipv4_cidr_blockbut not both. This field is applicable only whenuse_ip_aliasesis true.- Services
Ipv4Cidr stringBlock The IP address range used to allocate IP addresses in this cluster. Set to blank to have GKE choose a range with the default size. Set to /netmask (e.g. /14) to have GKE choose a range with a specific netmask. Set to a CIDR notation (e.g. 10.96.0.0/14) from the RFC-1918 private networks (e.g. 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16) to pick a specific range to use. Specify either
services_secondary_range_nameorservices_ipv4_cidr_blockbut not both.- Services
Secondary stringRange Name The name of the services’ secondary range used to allocate IP addresses to the cluster. Specify either
services_secondary_range_nameorservices_ipv4_cidr_blockbut not both. This field is applicable only whenuse_ip_aliasesis true.
- Use
Ip boolAliases Whether or not to enable Alias IPs in the GKE cluster. If true, a VPC-native cluster is created. Defaults to true if the
ip_allocation_blockis present in config.- Cluster
Ipv4Cidr stringBlock The IP address range used to allocate IP addresses to pods in the cluster. Set to blank to have GKE choose a range with the default size. Set to /netmask (e.g. /14) to have GKE choose a range with a specific netmask. Set to a CIDR notation (e.g. 10.96.0.0/14) from the RFC-1918 private networks (e.g. 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16) to pick a specific range to use. Specify either
cluster_secondary_range_nameorcluster_ipv4_cidr_blockbut not both.- Cluster
Secondary stringRange Name The name of the cluster’s secondary range used to allocate IP addresses to pods. Specify either
cluster_secondary_range_nameorcluster_ipv4_cidr_blockbut not both. This field is applicable only whenuse_ip_aliasesis true.- Services
Ipv4Cidr stringBlock The IP address range used to allocate IP addresses in this cluster. Set to blank to have GKE choose a range with the default size. Set to /netmask (e.g. /14) to have GKE choose a range with a specific netmask. Set to a CIDR notation (e.g. 10.96.0.0/14) from the RFC-1918 private networks (e.g. 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16) to pick a specific range to use. Specify either
services_secondary_range_nameorservices_ipv4_cidr_blockbut not both.- Services
Secondary stringRange Name The name of the services’ secondary range used to allocate IP addresses to the cluster. Specify either
services_secondary_range_nameorservices_ipv4_cidr_blockbut not both. This field is applicable only whenuse_ip_aliasesis true.
- use
Ip booleanAliases Whether or not to enable Alias IPs in the GKE cluster. If true, a VPC-native cluster is created. Defaults to true if the
ip_allocation_blockis present in config.- cluster
Ipv4Cidr stringBlock The IP address range used to allocate IP addresses to pods in the cluster. Set to blank to have GKE choose a range with the default size. Set to /netmask (e.g. /14) to have GKE choose a range with a specific netmask. Set to a CIDR notation (e.g. 10.96.0.0/14) from the RFC-1918 private networks (e.g. 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16) to pick a specific range to use. Specify either
cluster_secondary_range_nameorcluster_ipv4_cidr_blockbut not both.- cluster
Secondary stringRange Name The name of the cluster’s secondary range used to allocate IP addresses to pods. Specify either
cluster_secondary_range_nameorcluster_ipv4_cidr_blockbut not both. This field is applicable only whenuse_ip_aliasesis true.- services
Ipv4Cidr stringBlock The IP address range used to allocate IP addresses in this cluster. Set to blank to have GKE choose a range with the default size. Set to /netmask (e.g. /14) to have GKE choose a range with a specific netmask. Set to a CIDR notation (e.g. 10.96.0.0/14) from the RFC-1918 private networks (e.g. 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16) to pick a specific range to use. Specify either
services_secondary_range_nameorservices_ipv4_cidr_blockbut not both.- services
Secondary stringRange Name The name of the services’ secondary range used to allocate IP addresses to the cluster. Specify either
services_secondary_range_nameorservices_ipv4_cidr_blockbut not both. This field is applicable only whenuse_ip_aliasesis true.
- use
Ip boolAliases Whether or not to enable Alias IPs in the GKE cluster. If true, a VPC-native cluster is created. Defaults to true if the
ip_allocation_blockis present in config.- cluster
Ipv4Cidr strBlock The IP address range used to allocate IP addresses to pods in the cluster. Set to blank to have GKE choose a range with the default size. Set to /netmask (e.g. /14) to have GKE choose a range with a specific netmask. Set to a CIDR notation (e.g. 10.96.0.0/14) from the RFC-1918 private networks (e.g. 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16) to pick a specific range to use. Specify either
cluster_secondary_range_nameorcluster_ipv4_cidr_blockbut not both.- cluster
Secondary strRange Name The name of the cluster’s secondary range used to allocate IP addresses to pods. Specify either
cluster_secondary_range_nameorcluster_ipv4_cidr_blockbut not both. This field is applicable only whenuse_ip_aliasesis true.- services
Ipv4Cidr strBlock The IP address range used to allocate IP addresses in this cluster. Set to blank to have GKE choose a range with the default size. Set to /netmask (e.g. /14) to have GKE choose a range with a specific netmask. Set to a CIDR notation (e.g. 10.96.0.0/14) from the RFC-1918 private networks (e.g. 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16) to pick a specific range to use. Specify either
services_secondary_range_nameorservices_ipv4_cidr_blockbut not both.- services
Secondary strRange Name The name of the services’ secondary range used to allocate IP addresses to the cluster. Specify either
services_secondary_range_nameorservices_ipv4_cidr_blockbut not both. This field is applicable only whenuse_ip_aliasesis true.
EnvironmentConfigPrivateEnvironmentConfig
- Cloud
Sql stringIpv4Cidr Block The CIDR block from which IP range in tenant project will be reserved for Cloud SQL. Needs to be disjoint from
web_server_ipv4_cidr_block- Enable
Private boolEndpoint - If true, access to the public endpoint of the GKE cluster is denied.
- Master
Ipv4Cidr stringBlock The IP range in CIDR notation to use for the hosted master network. This range is used for assigning internal IP addresses to the cluster master or set of masters and to the internal load balancer virtual IP. This range must not overlap with any other ranges in use within the cluster’s network. If left blank, the default value of ‘172.16.0.0/28’ is used.
- Web
Server stringIpv4Cidr Block The CIDR block from which IP range for web server will be reserved. Needs to be disjoint from
master_ipv4_cidr_blockandcloud_sql_ipv4_cidr_block.
- Cloud
Sql stringIpv4Cidr Block The CIDR block from which IP range in tenant project will be reserved for Cloud SQL. Needs to be disjoint from
web_server_ipv4_cidr_block- Enable
Private boolEndpoint - If true, access to the public endpoint of the GKE cluster is denied.
- Master
Ipv4Cidr stringBlock The IP range in CIDR notation to use for the hosted master network. This range is used for assigning internal IP addresses to the cluster master or set of masters and to the internal load balancer virtual IP. This range must not overlap with any other ranges in use within the cluster’s network. If left blank, the default value of ‘172.16.0.0/28’ is used.
- Web
Server stringIpv4Cidr Block The CIDR block from which IP range for web server will be reserved. Needs to be disjoint from
master_ipv4_cidr_blockandcloud_sql_ipv4_cidr_block.
- cloud
Sql stringIpv4Cidr Block The CIDR block from which IP range in tenant project will be reserved for Cloud SQL. Needs to be disjoint from
web_server_ipv4_cidr_block- enable
Private booleanEndpoint - If true, access to the public endpoint of the GKE cluster is denied.
- master
Ipv4Cidr stringBlock The IP range in CIDR notation to use for the hosted master network. This range is used for assigning internal IP addresses to the cluster master or set of masters and to the internal load balancer virtual IP. This range must not overlap with any other ranges in use within the cluster’s network. If left blank, the default value of ‘172.16.0.0/28’ is used.
- web
Server stringIpv4Cidr Block The CIDR block from which IP range for web server will be reserved. Needs to be disjoint from
master_ipv4_cidr_blockandcloud_sql_ipv4_cidr_block.
- cloud
Sql strIpv4Cidr Block The CIDR block from which IP range in tenant project will be reserved for Cloud SQL. Needs to be disjoint from
web_server_ipv4_cidr_block- enable
Private boolEndpoint - If true, access to the public endpoint of the GKE cluster is denied.
- master
Ipv4Cidr strBlock The IP range in CIDR notation to use for the hosted master network. This range is used for assigning internal IP addresses to the cluster master or set of masters and to the internal load balancer virtual IP. This range must not overlap with any other ranges in use within the cluster’s network. If left blank, the default value of ‘172.16.0.0/28’ is used.
- web
Server strIpv4Cidr Block The CIDR block from which IP range for web server will be reserved. Needs to be disjoint from
master_ipv4_cidr_blockandcloud_sql_ipv4_cidr_block.
EnvironmentConfigSoftwareConfig
- Airflow
Config Dictionary<string, string>Overrides - (Optional) Apache Airflow configuration properties to override. Property keys contain the section and property names, separated by a hyphen, for example “core-dags_are_paused_at_creation”.
- Env
Variables Dictionary<string, string> Additional environment variables to provide to the Apache Airflow scheduler, worker, and webserver processes. Environment variable names must match the regular expression
[a-zA-Z_][a-zA-Z0-9_]*. They cannot specify Apache Airflow software configuration overrides (they cannot match the regular expressionAIRFLOW__[A-Z0-9_]+__[A-Z0-9_]+), and they cannot match any of the following reserved names:import * as pulumi from "@pulumi/pulumi";import pulumiusing Pulumi; class MyStack : Stack { public MyStack() { } }package main import ( "github.com/pulumi/pulumi/sdk/v2/go/pulumi" ) func main() { pulumi.Run(func(ctx *pulumi.Context) error { return nil }) }- Image
Version string - The version of the software running in the environment. This encapsulates both the version of Cloud Composer functionality and the version of Apache Airflow. It must match the regular expression
composer-[0-9]+\.[0-9]+(\.[0-9]+)?-airflow-[0-9]+\.[0-9]+(\.[0-9]+.*)?. The Cloud Composer portion of the version is a semantic version. The portion of the image version following ‘airflow-’ is an official Apache Airflow repository release name. See documentation for allowed release names.- Pypi
Packages Dictionary<string, string> Custom Python Package Index (PyPI) packages to be installed in the environment. Keys refer to the lowercase package name (e.g. “numpy”). Values are the lowercase extras and version specifier (e.g. “==1.12.0”, “[devel,gcp_api]“, “[devel]>=1.8.2, <1.9.2”). To specify a package without pinning it to a version specifier, use the empty string as the value.
- Python
Version string - The major version of Python used to run the Apache Airflow scheduler, worker, and webserver processes. Can be set to ‘2’ or ‘3’. If not specified, the default is ‘2’. Cannot be updated.
- Airflow
Config map[string]stringOverrides - (Optional) Apache Airflow configuration properties to override. Property keys contain the section and property names, separated by a hyphen, for example “core-dags_are_paused_at_creation”.
- Env
Variables map[string]string Additional environment variables to provide to the Apache Airflow scheduler, worker, and webserver processes. Environment variable names must match the regular expression
[a-zA-Z_][a-zA-Z0-9_]*. They cannot specify Apache Airflow software configuration overrides (they cannot match the regular expressionAIRFLOW__[A-Z0-9_]+__[A-Z0-9_]+), and they cannot match any of the following reserved names:import * as pulumi from "@pulumi/pulumi";import pulumiusing Pulumi; class MyStack : Stack { public MyStack() { } }package main import ( "github.com/pulumi/pulumi/sdk/v2/go/pulumi" ) func main() { pulumi.Run(func(ctx *pulumi.Context) error { return nil }) }- Image
Version string - The version of the software running in the environment. This encapsulates both the version of Cloud Composer functionality and the version of Apache Airflow. It must match the regular expression
composer-[0-9]+\.[0-9]+(\.[0-9]+)?-airflow-[0-9]+\.[0-9]+(\.[0-9]+.*)?. The Cloud Composer portion of the version is a semantic version. The portion of the image version following ‘airflow-’ is an official Apache Airflow repository release name. See documentation for allowed release names.- Pypi
Packages map[string]string Custom Python Package Index (PyPI) packages to be installed in the environment. Keys refer to the lowercase package name (e.g. “numpy”). Values are the lowercase extras and version specifier (e.g. “==1.12.0”, “[devel,gcp_api]“, “[devel]>=1.8.2, <1.9.2”). To specify a package without pinning it to a version specifier, use the empty string as the value.
- Python
Version string - The major version of Python used to run the Apache Airflow scheduler, worker, and webserver processes. Can be set to ‘2’ or ‘3’. If not specified, the default is ‘2’. Cannot be updated.
- airflow
Config {[key: string]: string}Overrides - (Optional) Apache Airflow configuration properties to override. Property keys contain the section and property names, separated by a hyphen, for example “core-dags_are_paused_at_creation”.
- env
Variables {[key: string]: string} Additional environment variables to provide to the Apache Airflow scheduler, worker, and webserver processes. Environment variable names must match the regular expression
[a-zA-Z_][a-zA-Z0-9_]*. They cannot specify Apache Airflow software configuration overrides (they cannot match the regular expressionAIRFLOW__[A-Z0-9_]+__[A-Z0-9_]+), and they cannot match any of the following reserved names:import * as pulumi from "@pulumi/pulumi";import pulumiusing Pulumi; class MyStack : Stack { public MyStack() { } }package main import ( "github.com/pulumi/pulumi/sdk/v2/go/pulumi" ) func main() { pulumi.Run(func(ctx *pulumi.Context) error { return nil }) }- image
Version string - The version of the software running in the environment. This encapsulates both the version of Cloud Composer functionality and the version of Apache Airflow. It must match the regular expression
composer-[0-9]+\.[0-9]+(\.[0-9]+)?-airflow-[0-9]+\.[0-9]+(\.[0-9]+.*)?. The Cloud Composer portion of the version is a semantic version. The portion of the image version following ‘airflow-’ is an official Apache Airflow repository release name. See documentation for allowed release names.- pypi
Packages {[key: string]: string} Custom Python Package Index (PyPI) packages to be installed in the environment. Keys refer to the lowercase package name (e.g. “numpy”). Values are the lowercase extras and version specifier (e.g. “==1.12.0”, “[devel,gcp_api]“, “[devel]>=1.8.2, <1.9.2”). To specify a package without pinning it to a version specifier, use the empty string as the value.
- python
Version string - The major version of Python used to run the Apache Airflow scheduler, worker, and webserver processes. Can be set to ‘2’ or ‘3’. If not specified, the default is ‘2’. Cannot be updated.
- airflow
Config Dict[str, str]Overrides - (Optional) Apache Airflow configuration properties to override. Property keys contain the section and property names, separated by a hyphen, for example “core-dags_are_paused_at_creation”.
- env_
variables Dict[str, str] Additional environment variables to provide to the Apache Airflow scheduler, worker, and webserver processes. Environment variable names must match the regular expression
[a-zA-Z_][a-zA-Z0-9_]*. They cannot specify Apache Airflow software configuration overrides (they cannot match the regular expressionAIRFLOW__[A-Z0-9_]+__[A-Z0-9_]+), and they cannot match any of the following reserved names:import * as pulumi from "@pulumi/pulumi";import pulumiusing Pulumi; class MyStack : Stack { public MyStack() { } }package main import ( "github.com/pulumi/pulumi/sdk/v2/go/pulumi" ) func main() { pulumi.Run(func(ctx *pulumi.Context) error { return nil }) }- image
Version str - The version of the software running in the environment. This encapsulates both the version of Cloud Composer functionality and the version of Apache Airflow. It must match the regular expression
composer-[0-9]+\.[0-9]+(\.[0-9]+)?-airflow-[0-9]+\.[0-9]+(\.[0-9]+.*)?. The Cloud Composer portion of the version is a semantic version. The portion of the image version following ‘airflow-’ is an official Apache Airflow repository release name. See documentation for allowed release names.- pypi
Packages Dict[str, str] Custom Python Package Index (PyPI) packages to be installed in the environment. Keys refer to the lowercase package name (e.g. “numpy”). Values are the lowercase extras and version specifier (e.g. “==1.12.0”, “[devel,gcp_api]“, “[devel]>=1.8.2, <1.9.2”). To specify a package without pinning it to a version specifier, use the empty string as the value.
- python
Version str - The major version of Python used to run the Apache Airflow scheduler, worker, and webserver processes. Can be set to ‘2’ or ‘3’. If not specified, the default is ‘2’. Cannot be updated.
EnvironmentConfigWebServerNetworkAccessControl
- Allowed
Ip List<EnvironmentRanges Config Web Server Network Access Control Allowed Ip Range Args> - A collection of allowed IP ranges with descriptions. Structure is documented below.
- Allowed
Ip []EnvironmentRanges Config Web Server Network Access Control Allowed Ip Range - A collection of allowed IP ranges with descriptions. Structure is documented below.
- allowed
Ip EnvironmentRanges Config Web Server Network Access Control Allowed Ip Range[] - A collection of allowed IP ranges with descriptions. Structure is documented below.
- allowed
Ip List[EnvironmentRanges Config Web Server Network Access Control Allowed Ip Range] - A collection of allowed IP ranges with descriptions. Structure is documented below.
EnvironmentConfigWebServerNetworkAccessControlAllowedIpRange
- Value string
IP address or range, defined using CIDR notation, of requests that this rule applies to. Examples:
192.168.1.1or192.168.0.0/16or2001:db8::/32or2001:0db8:0000:0042:0000:8a2e:0370:7334. IP range prefixes should be properly truncated. For example,1.2.3.4/24should be truncated to1.2.3.0/24. Similarly, for IPv6,2001:db8::1/32should be truncated to2001:db8::/32.- Description string
A description of this ip range.
- Value string
IP address or range, defined using CIDR notation, of requests that this rule applies to. Examples:
192.168.1.1or192.168.0.0/16or2001:db8::/32or2001:0db8:0000:0042:0000:8a2e:0370:7334. IP range prefixes should be properly truncated. For example,1.2.3.4/24should be truncated to1.2.3.0/24. Similarly, for IPv6,2001:db8::1/32should be truncated to2001:db8::/32.- Description string
A description of this ip range.
- value string
IP address or range, defined using CIDR notation, of requests that this rule applies to. Examples:
192.168.1.1or192.168.0.0/16or2001:db8::/32or2001:0db8:0000:0042:0000:8a2e:0370:7334. IP range prefixes should be properly truncated. For example,1.2.3.4/24should be truncated to1.2.3.0/24. Similarly, for IPv6,2001:db8::1/32should be truncated to2001:db8::/32.- description string
A description of this ip range.
- value str
IP address or range, defined using CIDR notation, of requests that this rule applies to. Examples:
192.168.1.1or192.168.0.0/16or2001:db8::/32or2001:0db8:0000:0042:0000:8a2e:0370:7334. IP range prefixes should be properly truncated. For example,1.2.3.4/24should be truncated to1.2.3.0/24. Similarly, for IPv6,2001:db8::1/32should be truncated to2001:db8::/32.- description str
A description of this ip range.
Package Details
- Repository
- https://github.com/pulumi/pulumi-gcp
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
google-betaTerraform Provider.