community.general.credstash 查找 - 从 AWS 上的 Credstash 检索密钥

注意

此查找插件是 community.general 集合（版本 10.1.0）的一部分。

如果您使用的是 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。您需要进一步的要求才能使用此查找插件，有关详细信息，请参见要求。

要在 playbook 中使用它，请指定：community.general.credstash。

概要

要求

本地控制器节点上需要以下要求才能执行此查找。

  • credstash (python 库)

术语

参数

注释

术语

list / elements=string / required

要在信用存储中查找的术语或术语列表

关键字参数

这描述了查找的关键字参数。这些值是 key1=value1、key2=value2 等，如下例所示：lookup('community.general.credstash', key1=value1, key2=value2, ...) 和 query('community.general.credstash', key1=value1, key2=value2, ...)

参数

注释

aws_access_key_id

字符串

AWS 访问密钥 ID

配置

aws_secret_access_key

字符串

AWS 访问密钥

配置

aws_session_token

字符串

AWS 会话令牌

配置

profile_name

字符串

用于身份验证的 AWS 配置文件

配置

region

字符串

AWS 区域

table

字符串

要查询的 credstash 表的名称

默认值： "credential-store"

version

字符串

Credstash 版本

默认值： ""

说明

注意

  • 当关键字和位置参数一起使用时，位置参数必须在关键字参数之前列出：lookup('community.general.credstash', term1, term2, key1=value1, key2=value2) 和 query('community.general.credstash', term1, term2, key1=value1, key2=value2)

示例

- name: first use credstash to store your secrets
  ansible.builtin.shell: credstash put my-github-password secure123

- name: "Test credstash lookup plugin -- get my github password"
  ansible.builtin.debug:
    msg: "Credstash lookup! {{ lookup('community.general.credstash', 'my-github-password') }}"

- name: "Test credstash lookup plugin -- get my other password from us-west-1"
  ansible.builtin.debug:
    msg: "Credstash lookup! {{ lookup('community.general.credstash', 'my-other-password', region='us-west-1') }}"

- name: "Test credstash lookup plugin -- get the company's github password"
  ansible.builtin.debug:
    msg: "Credstash lookup! {{ lookup('community.general.credstash', 'company-github-password', table='company-passwords') }}"

- name: Example play using the 'context' feature
  hosts: localhost
  vars:
    context:
      app: my_app
      environment: production
  tasks:

  - name: "Test credstash lookup plugin -- get the password with a context passed as a variable"
    ansible.builtin.debug:
      msg: "{{ lookup('community.general.credstash', 'some-password', context=context) }}"

  - name: "Test credstash lookup plugin -- get the password with a context defined here"
    ansible.builtin.debug:
      msg: "{{ lookup('community.general.credstash', 'some-password', context=dict(app='my_app', environment='production')) }}"

返回值

键

描述

返回值

字符串

存储在 Credstash 中的值。

返回：成功

作者

  • 未知

提示

每个条目类型的配置条目都具有从低到高的优先级顺序。例如，列表中较低的变量将覆盖较高的变量。