11. 自定义凭证类型¶

11.1. 从集合中获取内容¶

在 3.8 中，Tower 引入了一个新的 "由 Tower 管理的"凭证类型 kind=galaxy，它代表了在项目更新运行时用于获取在 requirements.yml 中定义的项的内容源（如 galaxy.ansible.com、cloud.redhat.com、premise Automation Hub）中定义的获取集合的内容源。 这个新类型带有在项目更新运行 ``ansible-galaxy collection install``（如 Ansible 文档 Configuring the ansible-galaxy client 所述）时构建环境变量所需的一个 URL 和可选的身份验证信息。它的字段直接映射到 Ansible Galaxy CLI 的配置选项，例如： per-server。 Tower API 中的端点反映了在机构级别的这些凭证排序的列表：

/api/v2/organizations/N/galaxy_credentials/

Ansible Tower 3.8 安装会迁移面向 Galaxy 的现有的设置值，在升级后，会创建正确的凭证并附加到 Tower 安装中的每个机构中。升级至 3.8 后，在升级前存在的每一个机构都会有一个与其关联的"Galaxy"凭证列表。

另外，这些设置在升级后无法通过 /api/v2/settings/jobs/ 端点查看（或进行编辑）。

即使 galaxy.ansible.com 不是机构凭证列表中的第一个凭证，Tower 仍会继续直接从公共 Galaxy 获取角色。 全局 "Galaxy" 设置将不再会在作业级别进行配置，而是在 Tower 用户界面中的机构级别进行配置。 机构的添加和编辑窗口中带有一个可选的、用于凭证 kind=galaxy 的 Credential 查找字段。

将这些凭证的顺序指定为内容同步和查询的顺序非常重要。如需了解更多信息，请参阅 创建新机构。有关如何使用集合设置项目的详情，请参阅 在 Tower 中使用集合。

11.2. 后向兼容 API 注意事项¶

支持 API 版本 2（api/v2/）意味着，作业模板与凭证有一对多的关系（包括多云支持）。凭证可以使用 v2 API 进行过滤：

$ curl "https://tower.example.org/api/v2/credentials/?credential_type__namespace=aws"

在 V2 CredentialType 模型中，关系定义如下：

11.3. 凭证类型入门¶

点击左侧导航栏中的 Credential Types () 图标访问 Credentials。如果没有创建自定义凭证类型，Credential Types 视图将不会显示任何自定义凭证类型，并会提示您添加一个：

如果创建了凭证类型，本页会显示所有现有和可用凭证类型的列表。

要查看有关凭证类型的更多信息，请点击其名称或 Actions 栏中的编辑 () 按钮。

如果适用，每个凭证类型都会在 Input Configuration 字段和 Injector Configuration 字段显示自己的唯一配置。配置字段中支持 YAML 和 JSON 两种格式。

11.4. 创建新凭证类型¶

要创建新凭证类型，请执行以下操作：

1. 点击 Credential Types 屏幕右上角的 按钮。

2. 在 Name 和 Description 字段中输入正确的详情。

3. 在 Input Configuration 字段中，指定为该类型定义一组排序字段的输入 schema。格式可以是 YAML 或 JSON，如下所示：

YAML

fields:
  - type: string
    id: username
    label: Username
  - type: string
    id: password
    label: Password
    secret: true
required:
  - username
  - password

要查看更多 YAML 示例，请访问 http://www.yaml.org/start.html。

JSON

{
"fields": [
  {
  "type": "string",
  "id": "username",
  "label": "Username"
  },
  {
  "secret": true,
  "type": "string",
  "id": "password",
  "label": "Password"
   }
  ],
 "required": ["username", "password"]
}

要查看更多 JSON 示例，请访问 www.json.org。

以下 JSON 格式的配置显示每个字段以及它们的使用方式：

{
  "fields": [{
    "id": "api_token",               # required - a unique name used to
                                     # reference the field value

    "label": "API Token",            # required - a unique label for the
                                     # field

    "help_text": "User-facing short text describing the field.",

    "type": ("string" | "boolean")   # defaults to 'string'

    "choices": ["A", "B", "C"]       # (only applicable to `type=string`)

    "format": "ssh_private_key"      # optional, can be used to enforce data
                                     # format validity for SSH private key
                                     # data (only applicable to `type=string`)

    "secret": true,                  # if true, the field value will be encrypted

    "multiline": false               # if true, the field should be rendered
                                     # as multi-line for input entry
                                     # (only applicable to `type=string`)
},{
    # field 2...
},{
    # field 3...
}],

"required": ["api_token"]            # optional; one or more fields can be marked as required
},

当 type=string 时，字段可以选择性地指定多个选择选项：

{
  "fields": [{
      "id": "api_token",          # required - a unique name used to reference the field value
      "label": "API Token",       # required - a unique label for the field
      "type": "string",
      "choices": ["A", "B", "C"]
  }]
},

4. 在 Injector Configuration 字段中，输入环境变量或额外变量来指定凭证类型可注入的值。格式可以为 YAML 或 JSON（请参阅上一步中的示例）。以下 JSON 格式的配置显示每个字段以及它们的使用方式：

{
  "file": {
      "template": "[mycloud]\ntoken={{ api_token }}"
  },
  "env": {
      "THIRD_PARTY_CLOUD_API_TOKEN": "{{ api_token }}"
  },
  "extra_vars": {
      "some_extra_var": "{{ username }}:{{ password }}"
  }
}

凭证类型还可生成临时文件来支持 .ini 文件或证书/密钥数据：

{
  "file": {
      "template": "[mycloud]\ntoken={{ api_token }}"
  },
  "env": {
      "MY_CLOUD_INI_FILE": "{{ tower.filename }}"
  }
}

在这个示例中，Tower 将编写包含以下内容的临时文件：

[mycloud]\ntoken=SOME_TOKEN_VALUE

所生成文件的绝对文件路径将存储在名为 MY_CLOUD_INI_FILE 的环境变量中。

以下是在自定义凭证模板中引用多个文件的示例：

Inputs

{
  "fields": [{
    "id": "cert",
    "label": "Certificate",
    "type": "string"
  },{
    "id": "key",
    "label": "Key",
    "type": "string"
  }]
}

Injectors

  {
    "file": {
      "template.cert_file": "[mycert]\n{{ cert }}",
      "template.key_file": "[mykey]\n{{ key }}"
  },
  "env": {
      "MY_CERT_INI_FILE": "{{ tower.filename.cert_file }}",
      "MY_KEY_INI_FILE": "{{ tower.filename.key_file }}"
  }
}

5. 完成后请点击 Save。

6. 向下滚动到屏幕底部，您新创建的凭证类型会出现在凭证类型列表中：

点击 或 分别可修改或删除 Actions 列下的凭证类型选项。

注解

如果要删除凭证正在使用的凭证类型，您必须先从所有使用该凭证类型的凭证中删除它，然后才能将它删除。以下是此类消息的示例：

7. 验证在创建新凭证时是否可从 Credential Type 选择窗口中选择新创建的凭证类型：

有关如何创建新凭证的详情，请参阅 凭证。