mirror of
https://github.com/ansible-collections/google.cloud.git
synced 2025-04-05 02:10:27 -07:00
Mirror of the Google Cloud collection for Ansible.
https://galaxy.ansible.com/ui/repo/published/google/cloud
307839b810
One niche but useful feature of Ansible inventory plugins is the ability to call one plugin from another. For example, you can write a custom plugin (`my.plugin.multi_cloud`) that acts as a sort of normalization interface between project inventories deployed on multiple cloud platforms. This makes it feasible to create a single set of Ansible Playbooks that can act on hosts across cloud platforms because they can expect managed node (inventory host) data to be consistent across those cloud platform vendors.
For example, `my.plugin.multi_cloud` inventory plugin might look something like the following code, which simply dynamically loads one or another underlying (upstream) vendor'ed inventory plugins based on the value of the shell environment variable called `CLOUD_PLATFORM`:
```python
#!/usr/bin/env python3
from ansible.errors import AnsibleError, AnsibleParserError
from ansible.plugins.inventory import BaseInventoryPlugin
from ansible.plugins.loader import inventory_loader
import os
class InventoryModule(BaseInventoryPlugin):
def parse(self, inventory, loader, path, cache=True):
super(InventoryModule, self).parse(inventory, loader, path)
# Map the cloud platform to the appropriate vendor's inventory plugin.
cloud_platform = os.environ.get('CLOUD_PLATFORM', '').lower()
if cloud_platform == 'aws':
plugin_fqcn = 'amazon.aws.aws_ec2'
elif cloud_platform == 'gcp':
plugin_fqcn = 'google.cloud.gcp_compute'
else:
raise AnsibleParserError(
f"Error: Unrecognized or unset cloud platform '{cloud_platform}'. "
f"Set ENTROPY_CLOUD_PLATFORM to 'aws' or 'gcp'.\n"
)
if not inventory_loader.has_plugin(plugin_fqcn):
raise AnsibleParserError(f"Error: '{plugin_fqcn}' inventory plugin not found.\n")
# Load the requested plugin.
self.inventory_plugin = inventory_loader.get(plugin_fqcn)
```
In the above example, we see code loading either this `google.cloud.gcp_compute` inventory plugin or Amazon's `amazon.aws.aws_ec2` inventory plugin.
Later, we can invoke the underlying (upstream) plugin in a passthrough manner like this:
```python
# Passthrough to the underlying plugin.
if self.inventory_plugin.verify_file(path):
self.inventory_plugin.parse(inventory, loader, path)
else:
raise AnsibleParserError(f"Error: Inventory configuration file '{path}' failed verification by plugin '{plugin_fqcn}'")
```
However, in order for this to work, we must supply the underlying plugin with knowledge of the fact that we are calling it from a different actual plugin. This is facilitated via Ansible's built in `_redirected_names` class property. Before calling the underlying plugin's `parse()` method, we must first do:
```python
self.inventory_plugin._redirected_names.append(InventoryModule.NAME)
```
Now the underlying plugin will be permitted to run because the underlying plugin is informing Ansible that one of the names it is permitted to use is this "redirected" (aliased) name of the calling plugin. We have effectively monkey-patched the plugin during runtime, which is exactly what we want.
Unfortunately, for _this_ `google.cloud.gcp_compute` inventory plugin, that's not enough, because of the fact that the `plugin` option in its configuration file is also checked and compared against this same name. That's something that, for example, the `amazon.aws.aws_ec2` inventory plugin _doesn't_ do, and for good reason: enforcing this check with hardcoded options breaks the built-in functionality of the Ansible module loading alias features.
That's why I'm suggesting we remove this option. It isn't needed for the `auto` inventory plugin to load the plugin correctly, nor does it ever really need to be checked once this plugin is actually running; it's already running! But its presence _does_ break existing Ansible features, and makes the above use case of a pass-through plugin, for example, infeasible.
Thanks for considering this proposal.
|
||
|---|---|---|
| .github/workflows | ||
| .vscode | ||
| changelogs | ||
| meta | ||
| molecule | ||
| plugins | ||
| roles | ||
| scripts | ||
| test-fixtures | ||
| tests | ||
| .ansible-lint | ||
| .gitignore | ||
| .gitmodules | ||
| .yamllint | ||
| CHANGELOG.rst | ||
| CONTRIBUTING.md | ||
| galaxy.yml | ||
| LICENSE | ||
| MAINTAINING.md | ||
| README.md | ||
| requirements-test.txt | ||
| requirements.txt | ||
Google Cloud Platform Ansible Collection
This collection provides a series of Ansible modules and plugins for interacting with the Google Cloud Platform
This collection works with Ansible 2.16+
Communication
-
Join the Ansible forum:
- Get Help: get help or help others. Please use appropriate tags, for example
cloud. - Social Spaces: gather and interact with fellow enthusiasts.
- News & Announcements: track project-wide announcements including social events.
- Get Help: get help or help others. Please use appropriate tags, for example
-
The Ansible Bullhorn newsletter: used to announce releases and important changes.
For more information about communication, see the Ansible communication guide.
Installation
ansible-galaxy collection install google.cloud
Resources Supported
- App Engine FirewallRule (gcp_appengine_firewall_rule, gcp_appengine_firewall_rule_info)
- BigQuery Dataset (gcp_bigquery_dataset, gcp_bigquery_dataset_info)
- BigQuery Table (gcp_bigquery_table, gcp_bigquery_table_info)
- Cloud Bigtable Instance (gcp_bigtable_instance, gcp_bigtable_instance_info)
- Cloud Build Trigger (gcp_cloudbuild_trigger, gcp_cloudbuild_trigger_info)
- Cloud Functions CloudFunction (gcp_cloudfunctions_cloud_function, gcp_cloudfunctions_cloud_function_info)
- Cloud Scheduler Job (gcp_cloudscheduler_job, gcp_cloudscheduler_job_info)
- Cloud Tasks Queue (gcp_cloudtasks_queue, gcp_cloudtasks_queue_info)
- Compute Engine Address (gcp_compute_address, gcp_compute_address_info)
- Compute Engine Autoscaler (gcp_compute_autoscaler, gcp_compute_autoscaler_info)
- Compute Engine BackendBucket (gcp_compute_backend_bucket, gcp_compute_backend_bucket_info)
- Compute Engine BackendService (gcp_compute_backend_service, gcp_compute_backend_service_info)
- Compute Engine RegionBackendService (gcp_compute_region_backend_service, gcp_compute_region_backend_service_info)
- Compute Engine Disk (gcp_compute_disk, gcp_compute_disk_info)
- Compute Engine Firewall (gcp_compute_firewall, gcp_compute_firewall_info)
- Compute Engine ForwardingRule (gcp_compute_forwarding_rule, gcp_compute_forwarding_rule_info)
- Compute Engine GlobalAddress (gcp_compute_global_address, gcp_compute_global_address_info)
- Compute Engine GlobalForwardingRule (gcp_compute_global_forwarding_rule, gcp_compute_global_forwarding_rule_info)
- Compute Engine HttpHealthCheck (gcp_compute_http_health_check, gcp_compute_http_health_check_info)
- Compute Engine HttpsHealthCheck (gcp_compute_https_health_check, gcp_compute_https_health_check_info)
- Compute Engine HealthCheck (gcp_compute_health_check, gcp_compute_health_check_info)
- Compute Engine InstanceTemplate (gcp_compute_instance_template, gcp_compute_instance_template_info)
- Compute Engine Image (gcp_compute_image, gcp_compute_image_info)
- Compute Engine Instance (gcp_compute_instance, gcp_compute_instance_info)
- Compute Engine InstanceGroup (gcp_compute_instance_group, gcp_compute_instance_group_info)
- Compute Engine InstanceGroupManager (gcp_compute_instance_group_manager, gcp_compute_instance_group_manager_info)
- Compute Engine RegionInstanceGroupManager (gcp_compute_region_instance_group_manager, gcp_compute_region_instance_group_manager_info)
- Compute Engine InterconnectAttachment (gcp_compute_interconnect_attachment, gcp_compute_interconnect_attachment_info)
- Compute Engine Network (gcp_compute_network, gcp_compute_network_info)
- Compute Engine NetworkEndpointGroup (gcp_compute_network_endpoint_group, gcp_compute_network_endpoint_group_info)
- Compute Engine NodeGroup (gcp_compute_node_group, gcp_compute_node_group_info)
- Compute Engine NodeTemplate (gcp_compute_node_template, gcp_compute_node_template_info)
- Compute Engine RegionAutoscaler (gcp_compute_region_autoscaler, gcp_compute_region_autoscaler_info)
- Compute Engine RegionDisk (gcp_compute_region_disk, gcp_compute_region_disk_info)
- Compute Engine RegionUrlMap (gcp_compute_region_url_map, gcp_compute_region_url_map_info)
- Compute Engine RegionHealthCheck (gcp_compute_region_health_check, gcp_compute_region_health_check_info)
- Compute Engine ResourcePolicy (gcp_compute_resource_policy, gcp_compute_resource_policy_info)
- Compute Engine Route (gcp_compute_route, gcp_compute_route_info)
- Compute Engine Router (gcp_compute_router, gcp_compute_router_info)
- Compute Engine Snapshot (gcp_compute_snapshot, gcp_compute_snapshot_info)
- Compute Engine SslCertificate (gcp_compute_ssl_certificate, gcp_compute_ssl_certificate_info)
- Compute Engine Reservation (gcp_compute_reservation, gcp_compute_reservation_info)
- Compute Engine SslPolicy (gcp_compute_ssl_policy, gcp_compute_ssl_policy_info)
- Compute Engine Subnetwork (gcp_compute_subnetwork, gcp_compute_subnetwork_info)
- Compute Engine TargetHttpProxy (gcp_compute_target_http_proxy, gcp_compute_target_http_proxy_info)
- Compute Engine TargetHttpsProxy (gcp_compute_target_https_proxy, gcp_compute_target_https_proxy_info)
- Compute Engine RegionTargetHttpProxy (gcp_compute_region_target_http_proxy, gcp_compute_region_target_http_proxy_info)
- Compute Engine RegionTargetHttpsProxy (gcp_compute_region_target_https_proxy, gcp_compute_region_target_https_proxy_info)
- Compute Engine TargetInstance (gcp_compute_target_instance, gcp_compute_target_instance_info)
- Compute Engine TargetPool (gcp_compute_target_pool, gcp_compute_target_pool_info)
- Compute Engine TargetSslProxy (gcp_compute_target_ssl_proxy, gcp_compute_target_ssl_proxy_info)
- Compute Engine TargetTcpProxy (gcp_compute_target_tcp_proxy, gcp_compute_target_tcp_proxy_info)
- Compute Engine TargetVpnGateway (gcp_compute_target_vpn_gateway, gcp_compute_target_vpn_gateway_info)
- Compute Engine UrlMap (gcp_compute_url_map, gcp_compute_url_map_info)
- Compute Engine VpnTunnel (gcp_compute_vpn_tunnel, gcp_compute_vpn_tunnel_info)
- Google Kubernetes Engine Cluster (gcp_container_cluster, gcp_container_cluster_info)
- Google Kubernetes Engine NodePool (gcp_container_node_pool, gcp_container_node_pool_info)
- Cloud DNS ManagedZone (gcp_dns_managed_zone, gcp_dns_managed_zone_info)
- Cloud DNS ResourceRecordSet (gcp_dns_resource_record_set, gcp_dns_resource_record_set_info)
- Filestore Instance (gcp_filestore_instance, gcp_filestore_instance_info)
- Cloud IAM Role (gcp_iam_role, gcp_iam_role_info)
- Cloud IAM ServiceAccount (gcp_iam_service_account, gcp_iam_service_account_info)
- Cloud IAM ServiceAccountKey (gcp_iam_service_account_key, gcp_iam_service_account_key_info)
- Cloud Key Management Service KeyRing (gcp_kms_key_ring, gcp_kms_key_ring_info)
- Cloud Key Management Service CryptoKey (gcp_kms_crypto_key, gcp_kms_crypto_key_info)
- Cloud (Stackdriver) Logging Metric (gcp_logging_metric, gcp_logging_metric_info)
- ML Engine Model (gcp_mlengine_model, gcp_mlengine_model_info)
- ML Engine Version (gcp_mlengine_version, gcp_mlengine_version_info)
- Cloud Pub/Sub Topic (gcp_pubsub_topic, gcp_pubsub_topic_info)
- Cloud Pub/Sub Subscription (gcp_pubsub_subscription, gcp_pubsub_subscription_info)
- Memorystore (Redis) Instance (gcp_redis_instance, gcp_redis_instance_info)
- Resource Manager Project (gcp_resourcemanager_project, gcp_resourcemanager_project_info)
- Runtime Configurator Config (gcp_runtimeconfig_config, gcp_runtimeconfig_config_info)
- Runtime Configurator Variable (gcp_runtimeconfig_variable, gcp_runtimeconfig_variable_info)
- Service Usage Service (gcp_serviceusage_service, gcp_serviceusage_service_info)
- Cloud Source Repositories Repository (gcp_sourcerepo_repository, gcp_sourcerepo_repository_info)
- Cloud Spanner Instance (gcp_spanner_instance, gcp_spanner_instance_info)
- Cloud Spanner Database (gcp_spanner_database, gcp_spanner_database_info)
- Cloud SQL Instance (gcp_sql_instance, gcp_sql_instance_info)
- Cloud SQL Database (gcp_sql_database, gcp_sql_database_info)
- Cloud SQL User (gcp_sql_user, gcp_sql_user_info)
- Cloud SQL SslCert (gcp_sql_ssl_cert, gcp_sql_ssl_cert_info)
- Cloud Storage Bucket (gcp_storage_bucket, gcp_storage_bucket_info)
- Cloud Storage BucketAccessControl (gcp_storage_bucket_access_control, gcp_storage_bucket_access_control_info)
- Cloud Storage DefaultObjectACL (gcp_storage_default_object_acl, gcp_storage_default_object_acl_info)
- Cloud TPU Node (gcp_tpu_node, gcp_tpu_node_info)
- Secret Manager (gcp_secret_manager)