如何将GCE实例元数据用作Ansible Facts或变量？

不用纠结那个停更的第三方模块啦，GCE每个实例都能直接访问内置的元数据服务器（地址是http://metadata.google.internal），我们用Ansible原生模块就能拉取这些数据，转成自定义Facts，完全满足你想要的{{ gce_fact_instance_name }}这类变量形式。

核心思路 #

GCE元数据服务器提供了实例的全量元数据接口，实例内部访问无需额外身份验证（默认授权）。我们通过uri模块请求这些接口，把返回的JSON数据提取成自定义Facts即可，全程依赖Ansible内置功能，稳定又可靠。

完整Playbook示例 #

下面是可以直接复用的Playbook，会收集你需要的所有元数据并设置为Facts：

- name: Collect GCE instance metadata as Ansible Facts
  hosts: all
  gather_facts: yes
  tasks:
    - name: Fetch core instance metadata from GCE metadata server
      uri:
        url: "http://metadata.google.internal/computeMetadata/v1/instance/?recursive=true"
        headers:
          Metadata-Flavor: Google
        return_content: yes
        status_code: 200
      register: gce_core_metadata_raw

    - name: Set core GCE instance Facts
      set_fact:
        gce_fact_instance_name: "{{ gce_core_metadata_raw.json.name }}"
        # 从完整zone路径中提取可用区名称（例如把projects/xxx/zones/us-central1-b转成us-central1-b）
        gce_fact_zone: "{{ gce_core_metadata_raw.json.zone | regex_replace('^.*/', '') }}"
        gce_fact_project_id: "{{ gce_core_metadata_raw.json.projectId }}"
        # 提取机器类型名称（例如把projects/xxx/machineTypes/n2-standard-2转成n2-standard-2）
        gce_fact_machine_type: "{{ gce_core_metadata_raw.json.machineType | regex_replace('^.*/', '') }}"
        # 获取第一个网卡的外部IP，无外部IP时默认返回None
        gce_fact_external_ip: "{{ gce_core_metadata_raw.json.networkInterfaces[0].accessConfigs[0].natIP | default('None', true) }}"

    - name: Fetch custom instance metadata from GCE metadata server
      uri:
        url: "http://metadata.google.internal/computeMetadata/v1/instance/attributes/?recursive=true"
        headers:
          Metadata-Flavor: Google
        return_content: yes
        status_code: 200
      register: gce_custom_metadata_raw

    - name: Set custom GCE instance Facts
      set_fact:
        gce_fact_custom_metadata: "{{ gce_custom_metadata_raw.json }}"

    # 测试输出（可选，用于验证Facts是否正确）
    - name: Print collected GCE Facts
      debug:
        msg: |
          Instance Name: {{ gce_fact_instance_name }}
          Zone: {{ gce_fact_zone }}
          Project ID: {{ gce_fact_project_id }}
          Machine Type: {{ gce_fact_machine_type }}
          External IP: {{ gce_fact_external_ip }}
          Custom Metadata: {{ gce_fact_custom_metadata }}

关键说明 #

1. 无额外依赖：仅使用Ansible内置的uri和set_fact模块，彻底摆脱第三方模块的维护风险。
2. 全实例兼容：所有GCE实例（公共镜像/自定义镜像均可）都能访问元数据服务器，适配性拉满。
3. 灵活扩展：如果需要更多元数据（比如磁盘信息、实例标签等），直接从gce_core_metadata_raw.json中提取对应字段即可，参考GCE官方元数据结构说明就能轻松扩展。
4. 异常防护：对可能不存在的字段（如无外部IP的实例），用default()方法避免报错，提升Playbook健壮性。

使用方式 #

把这个Playbook加入你的Ansible流程，收集完Facts后，后续任务就能直接用{{ gce_fact_instance_name }}、{{ gce_fact_custom_metadata.your_custom_key }}这类变量啦。

内容的提问来源于stack exchange，提问作者Danny F