community.digitalocean.digital_ocean_sshkey 模块 – 管理 DigitalOcean SSH 密钥

注意

此模块是 community.digitalocean 集合（版本 1.27.0）的一部分。

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

要安装它，请使用：ansible-galaxy collection install community.digitalocean。您需要其他要求才能使用此模块，有关详细信息，请参阅要求。

要在 playbook 中使用它，请指定：community.digitalocean.digital_ocean_sshkey。

概要

  • 创建/删除 DigitalOcean SSH 密钥。

要求

在执行此模块的主机上需要以下要求。

  • python >= 2.6

参数

参数

注释

baseurl

字符串

DigitalOcean API 基本 URL。

默认值： "https://api.digitalocean.com/v2"

指纹

别名：id

字符串

这是用于删除密钥的 SSH 密钥的唯一标识符

name

字符串

SSH 密钥的名称

oauth_token

别名：api_token

字符串

DigitalOcean OAuth 令牌。

还有其他几个环境变量可用于提供此值。

例如，- DO_API_TOKEN、DO_API_KEY、DO_OAUTH_TOKEN 和 OAUTH_TOKEN。

ssh_pub_key

字符串

要添加的公共 SSH 密钥。

state

字符串

指示目标所需的state。

选择

  • "present" ←（默认）

  • "absent"

timeout

整数

用于轮询 DigitalOcean API 的超时秒数。

默认值： 30

validate_certs

布尔值

如果设置为 no，则不会验证 SSL 证书。

仅应在个人控制的使用自签名证书的站点上设置为 no。

选择

  • false

  • true ←（默认）

注释

注意

  • 使用 DigitalOcean API 的版本 2。

示例

- name: "Create ssh key"
  community.digitalocean.digital_ocean_sshkey:
    oauth_token: "{{ oauth_token }}"
    name: "My SSH Public Key"
    ssh_pub_key: "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAQQDDHr/jh2Jy4yALcK4JyWbVkPRaWmhck3IgCoeOO3z1e2dBowLh64QAM+Qb72pxekALga2oi4GvT+TlWNhzPH4V example"
    state: present
  register: result

- name: "Delete ssh key"
  community.digitalocean.digital_ocean_sshkey:
    oauth_token: "{{ oauth_token }}"
    state: "absent"
    fingerprint: "3b:16:bf:e4:8b:00:8b:b8:59:8c:a9:d3:f0:19:45:fa"

返回值

常见返回值记录在此处，以下是此模块特有的字段

键

描述

data

字典

仅当 state=present 时才会显示此项

返回：当 state=present 时

示例：{"ssh_key": {"fingerprint": "3b:16:bf:e4:8b:00:8b:b8:59:8c:a9:d3:f0:19:45:fa", "id": 512189, "name": "My SSH Public Key", "public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAQQDDHr/jh2Jy4yALcK4JyWbVkPRaWmhck3IgCoeOO3z1e2dBowLh64QAM+Qb72pxekALga2oi4GvT+TlWNhzPH4V example"}}

作者

  • Patrick Marques (@pmarques)