### Install Molecule Podman Plugin

Source: https://github.com/ansible-collections/google.cloud/blob/master/CONTRIBUTING.md

Install the molecule-plugins package with podman support for role testing.

```shell
pip install --upgrade molecule-plugins[podman]
```

--------------------------------

### Basic gcloud Installation Playbook

Source: https://github.com/ansible-collections/google.cloud/blob/master/roles/gcloud/README.md

This is a basic example of how to include the gcloud role in your Ansible playbook. Ensure the `google.cloud.gcloud` role is available in your roles path.

```yaml
- hosts: servers
  roles:
     - role: google.cloud.gcloud
```

--------------------------------

### Clone Repository and Setup Environment

Source: https://github.com/ansible-collections/google.cloud/blob/master/CONTRIBUTING.md

Clone the google.cloud repository and set up the Python virtual environment with necessary dependencies.

```shell
mkdir -p $TARGET_DIR/ansible_collections/google
git clone <url> $TARGET_DIR/ansible_collections/google/cloud
```

```shell
cd $TARGET_DIR/ansible_collections/google/cloud
python3 -m venv venv
. ./venv/bin/activate
pip3 install -r requirements.txt
pip3 install -r requirements-test.txt
pip3 install ansible
```

--------------------------------

### Install Google Cloud Collection

Source: https://github.com/ansible-collections/google.cloud/blob/master/README.md

Installs the google.cloud collection using the Ansible Galaxy command-line tool.

```bash
ansible-galaxy collection install google.cloud
```

--------------------------------

### Install Google Cloud Collection via requirements.yml

Source: https://github.com/ansible-collections/google.cloud/blob/master/README.md

Installs the google.cloud collection by referencing it in a requirements.yml file.

```yaml
collections:
  - name: google.cloud
```

--------------------------------

### Example Playbook for gcp_http_lb Role

Source: https://github.com/ansible-collections/google.cloud/blob/master/roles/gcp_http_lb/README.md

An example Ansible playbook demonstrating how to use the gcp_http_lb role. It specifies the backend for the load balancer.

```yaml
- hosts: local
  vars:
    gcp_http_lb_backend: projects/project/zones/us-central1-c/instanceGroups/my-instance-group
  roles:
     - role: gcp_http_lb
```

--------------------------------

### Install Specific Version of Google Cloud Collection

Source: https://github.com/ansible-collections/google.cloud/blob/master/README.md

Installs a specific version (e.g., 1.5.1) of the google.cloud collection.

```bash
ansible-galaxy collection install google.cloud:==1.5.1
```

--------------------------------

### Create Google Cloud Storage Bucket with Service Account Key

Source: https://github.com/ansible-collections/google.cloud/blob/master/README.md

Example playbook task to create a Google Cloud Storage bucket using a service account key file.

```yaml
- name: Create a Google Cloud Storage bucket
  google.cloud.gcp_storage_bucket:
    name: "{{ bucket_name }}"
    project: "{{ gcp_project }}"
    auth_kind: "serviceaccount"
    service_account_file: "{{ gcp_cred_file }}"
    state: present
```

--------------------------------

### Install and Run antsibull-changelog

Source: https://github.com/ansible-collections/google.cloud/blob/master/MAINTAINING.md

Use the antsibull-changelog tool to generate or update the CHANGELOG.rst file. This command installs the tool and then runs the release command to merge changelog fragments.

```sh
pip install antsibull-changelog
antsibull-changelog release
```

--------------------------------

### Authenticate with gcloud and Application Default Credentials

Source: https://github.com/ansible-collections/google.cloud/blob/master/README.md

Example playbook task to create a Google Cloud Storage bucket using application default credentials.

```yaml
- name: Create a Google Cloud Storage bucket
  google.cloud.gcp_storage_bucket:
    name: "{{ bucket_name }}"
    project: "{{ gcp_project }}"
    auth_kind: "application"
    state: present
```

--------------------------------

### Example Ansible Collection Plugins Directory Structure

Source: https://github.com/ansible-collections/google.cloud/blob/master/plugins/README.md

This snippet illustrates the typical layout for organizing various plugin types within an Ansible collection's plugins directory. It includes common plugin categories and directories for module utilities and modules.

```text
└── plugins
    ├── action
    ├── become
    ├── cache
    ├── callback
    ├── cliconf
    ├── connection
    ├── filter
    ├── httpapi
    ├── inventory
    ├── lookup
    ├── module_utils
    ├── modules
    ├── netconf
    ├── shell
    ├── strategy
    ├── terminal
    ├── test
    └── vars
```

--------------------------------

### Delete Google Cloud Storage Bucket with Application Default Credentials

Source: https://github.com/ansible-collections/google.cloud/blob/master/README.md

Example playbook task to delete a Google Cloud Storage bucket using application default credentials.

```yaml
- name: Delete a Google Cloud Storage bucket
  google.cloud.gcp_storage_bucket:
    name: "{{ bucket_name }}"
    project: "{{ gcp_project }}"
    auth_kind: "application"
    state: absent
```

--------------------------------

### Delete Google Cloud Storage Bucket with Service Account Key

Source: https://github.com/ansible-collections/google.cloud/blob/master/README.md

Example playbook task to delete a Google Cloud Storage bucket using a service account key file.

```yaml
- name: Delete a Google Cloud Storage bucket
  google.cloud.gcp_storage_bucket:
    name: "{{ bucket_name }}"
    project: "{{ gcp_project }}"
    auth_kind: "serviceaccount"
    service_account_file: "{{ gcp_cred_file }}"
    state: absent
```

--------------------------------

### Bootstrap Project for Testing

Source: https://github.com/ansible-collections/google.cloud/blob/master/CONTRIBUTING.md

Run the bootstrap script to set up the GCP project for testing. This script makes irreversible changes.

```bash
bash ./scripts/bootstrap-project.sh $PROJECT_ID $SERVICE_ACCOUNT_NAME
```

--------------------------------

### Generate and Secure Service Account Key

Source: https://github.com/ansible-collections/google.cloud/blob/master/CONTRIBUTING.md

Create a key file for a service account and set appropriate permissions.

```shell
gcloud iam service-accounts keys create /path/to/cred/file.json \
    --iam-account=ansible-test-account@my-test-project.iam.gserviceaccount.com
chmod 0600 /path/to/cred/file.json
```

--------------------------------

### Run Integration Tests

Source: https://github.com/ansible-collections/google.cloud/blob/master/CONTRIBUTING.md

Execute integration tests for the google.cloud collection using ansible-test.

```shell
ansible-test integration
```

--------------------------------

### Create GCP Service Account for Testing

Source: https://github.com/ansible-collections/google.cloud/blob/master/CONTRIBUTING.md

Create a GCP service account specifically for running Ansible integration tests.

```shell
gcloud iam service-accounts create ansible-test-account \
    --description="For running Anisble integration tests" \
    --display-name="Ansible Test Account"
```

--------------------------------

### Run Role Tests with Molecule

Source: https://github.com/ansible-collections/google.cloud/blob/master/CONTRIBUTING.md

Execute role tests using molecule. Specify the role name and optionally the podman driver.

```shell
module debug --test -s ${ROLE}
```

```shell
module debug --test -s ${ROLE} -d podman
```

--------------------------------

### Set Google Cloud Environment Variables

Source: https://github.com/ansible-collections/google.cloud/blob/master/README.md

Sets environment variables for Google Cloud authentication and configuration, useful for unattended operations.

```shell
export GCP_PROJECT=<project id>
export GCP_AUTH_KIND=<application|serviceaccount|accesstoken>
export GCP_SERVICE_ACCOUNT_FILE=</path/to/service/account/key.json>
export GCP_SERVICE_ACCOUNT_CONTENTS=<alternative that stores the service account key in the env var>
export GCP_SCOPES=<requested scopes such as https://www.googleapis.com/auth/compute>
export GCP_REGION=<default region such as us-central1>
export GCP_ZONE=<default zone such as us-central1-a>
```

--------------------------------

### Run Ansible Lint

Source: https://github.com/ansible-collections/google.cloud/blob/master/CONTRIBUTING.md

Execute ansible-lint directly to check for linting errors in the collection.

```shell
ansible-lint
```

--------------------------------

### Authenticate with GCP Application Default Credentials

Source: https://github.com/ansible-collections/google.cloud/blob/master/CONTRIBUTING.md

Log in to authenticate using Application Default Credentials for local integration testing.

```shell
gcloud auth application-default login
```

--------------------------------

### GCP Dynamic Inventory with IAP Plugin Configuration

Source: https://github.com/ansible-collections/google.cloud/blob/master/plugins/connection/README.md

Integrate the GCP dynamic inventory with the IAP plugin by specifying zones, projects, service account details, and authentication parameters. This allows for dynamic zone population and filtering of instances.

```yaml
plugin: google.cloud.gcp_compute
zones:
  - us-central1-a
  - us-central1-b
  - us-central1-c
  - us-central1-f
projects:
  - my-project
service_account_file: /path/to/my/service-account.json
auth_kind: serviceaccount
scopes:
  - 'https://www.googleapis.com/auth/cloud-platform'
  - 'https://www.googleapis.com/auth/compute.readonly'

# Create groups from labels e.g.
keyed_groups:
  - prefix: gcp
    key: labels.gcp_role

# inventory_hostname needs to be the actual name of the instance
hostnames:
  - name

# fetch zone dynamically to feed IAP plugin
compose:
  ansible_gcloud_zone: zone

# maybe add some filters
filters:
  - 'status = RUNNING'
  - 'labels.my-special-label:some-value'
```

--------------------------------

### Configure GCP Credentials for Integration Tests (Application Default)

Source: https://github.com/ansible-collections/google.cloud/blob/master/CONTRIBUTING.md

Configure the integration tests to use Application Default Credentials for GCP.

```ini
[default]
gcp_project: $PROJECT_ID
gcp_cred_kind: application
gcp_folder_id: $TEST_FOLDER (to create test projects)
```

--------------------------------

### Configure GCP Credentials for Integration Tests (Service Account)

Source: https://github.com/ansible-collections/google.cloud/blob/master/CONTRIBUTING.md

Configure the integration tests to use a service account for GCP credentials.

```ini
[default]
gcp_project: $PROJECT_ID
gcp_cred_file: /path/to/cred/file.json
gcp_cred_kind: serviceaccount
gcp_folder_id: $TEST_FOLDER (to create test projects)
```

--------------------------------

### Build Ansible Collection Package Locally

Source: https://github.com/ansible-collections/google.cloud/blob/master/MAINTAINING.md

Build the Ansible collection package locally using the 'ansible-galaxy collection build' command. This prepares the collection for publishing.

```sh
ansible-galaxy collection build .
```

--------------------------------

### Configure IAP Connection Plugin in ansible.cfg

Source: https://github.com/ansible-collections/google.cloud/blob/master/plugins/connection/README.md

Set gcloud CLI parameters like account, project, and region within the [gcloud] section of your ansible.cfg file to configure the IAP connection plugin.

```ini
[gcloud]
account = my-service-account@my-project.iam.gserviceaccount.com
project = my-project
region = us-central1
zone = us-central1-a
```

--------------------------------

### Upgrade Google Cloud Collection

Source: https://github.com/ansible-collections/google.cloud/blob/master/README.md

Upgrades the google.cloud collection to the latest available version using Ansible Galaxy.

```bash
ansible-galaxy collection install google.cloud --upgrade
```

--------------------------------

### GCP HTTP LB Role Variables

Source: https://github.com/ansible-collections/google.cloud/blob/master/roles/gcp_http_lb/README.md

Defines key variables for the gcp_http_lb role, including backend self-link, project name, and service account file path.

```yaml
gcp_http_lb_backend: the selflink for the backend that this load balancer will be supporting
gcp_http_lb_gcp_project: the name of your gcp project
gcp_http_lb_service_account_file: the path to your service account JSON file
```

--------------------------------

### Update Collection Version in galaxy.yml

Source: https://github.com/ansible-collections/google.cloud/blob/master/MAINTAINING.md

Modify the galaxy.yml file to specify the new collection version. Collection versions must adhere to SEMVER standards.

```yaml
version: {NEW_VERSION}
```

--------------------------------

### Include gcsfuse Role in Playbook

Source: https://github.com/ansible-collections/google.cloud/blob/master/roles/gcsfuse/README.md

This snippet shows how to include the gcsfuse Ansible role in a playbook. Ensure the role is correctly named and available in your Ansible environment.

```yaml
- hosts: servers
  tasks:
    - include_role:
        name: google.cloud.gcsfuse

```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.