红帽 AWX 提供了一个类似 Swagger 的 RESTful 风格的 Web 服务框架,可以和 awx 直接交互。使管理员和开发人员能够在 web UI之外控制其 AWX 环境。
可以使用自定义脚本或外部应用使用标准HTTP消息访问API。尤其一些 devops 的联动、钩子相关的处理,REST API 的优势之一在于,任何支持 HTTP 协议的编程语言、框架或系统都可以使用API。这提供了一种简单的方式来自动化重复性任务,并将其他企业IT系统与 AWX 集成。
REST架构在客户端和服务器之间提供了无状态通信通道。每个客户端请求的行为都独立于任何其他请求,并且包含完成该请求所需的所有信息。
请求使用HTTP获取方法检索API主入口点:
命令行访问RESTAPI示例:使用HTTP GET方法检索API主入口点。
这里为了展示可读,我们需要安装一个 json 的 格式化插件 jq
┌──[root@vms81.liruilongs.github.io]-[~]
└─$yum -y install jq
查看 API 版本等相关信息,这里的 -k参数取消 tocker 认证, -s 取消请求的过程展示
┌──[root@vms81.liruilongs.github.io]-[~]
└─$curl -X GET http://192.168.26.82:30066/api/ -s -k | jq
{
"description": "AWX REST API",
"current_version": "/api/v2/",
"available_versions": {
"v2": "/api/v2/"
},
"oauth2": "/api/o/",
"custom_logo": "",
"custom_login_info": "",
"login_redirect_override": ""
}
┌──[root@vms81.liruilongs.github.io]-[~]
└─$
查看 当前版本的 所有 API 接口
┌──[root@vms81.liruilongs.github.io]-[~]
└─$curl -X GET http://192.168.26.82:30066/api/v2/ -s -k | jq
{
"ping": "/api/v2/ping/",
"instances": "/api/v2/instances/",
"instance_groups": "/api/v2/instance_groups/",
"config": "/api/v2/config/",
"settings": "/api/v2/settings/",
"me": "/api/v2/me/",
"dashboard": "/api/v2/dashboard/",
"organizations": "/api/v2/organizations/",
"users": "/api/v2/users/",
"execution_environments": "/api/v2/execution_environments/",
"projects": "/api/v2/projects/",
"project_updates": "/api/v2/project_updates/",
"teams": "/api/v2/teams/",
"credentials": "/api/v2/credentials/",
"credential_types": "/api/v2/credential_types/",
"credential_input_sources": "/api/v2/credential_input_sources/",
"applications": "/api/v2/applications/",
"tokens": "/api/v2/tokens/",
.........
"mesh_visualizer": "/api/v2/mesh_visualizer/"
}
┌──[root@vms81.liruilongs.github.io]-[~]
└─$
查看指定业务接口的相关信息
┌──[root@vms81.liruilongs.github.io]-[~]
└─$curl -X GET http://192.168.26.82:30066/api/v2/ping/ -s -k | jq
{
"ha": false,
"version": "21.7.0",
"active_node": "awx-demo-65d9bf775b-hc58x",
"install_uuid": "d969a45a-6674-4e6b-87a5-2f4184de62b0",
"instances": [
{
"node": "awx-demo-65d9bf775b-hc58x",
"node_type": "control",
"uuid": "e01fe449-b2f6-4df4-ae55-a5639f601b7b",
"heartbeat": "2022-10-24T08:20:04.405470Z",
"capacity": 79,
"version": "21.7.0"
}
],
"instance_groups": [
{
"name": "controlplane",
"capacity": 79,
"instances": [
"awx-demo-65d9bf775b-hc58x"
]
},
{
"name": "default",
"capacity": 0,
"instances": []
}
]
}
查看主机的相关的信息,这里需要登录,所以提示么有会话信息
┌──[root@vms81.liruilongs.github.io]-[~]
└─$curl -X GET http://192.168.26.82:30066/api/v2/hosts/ -s -k | jq
{
"detail": "Authentication credentials were not provided. To establish a login session, visit /api/login/."
}
传递用户名密码就可以查看主机信息
┌──[root@vms81.liruilongs.github.io]-[~]
└─$curl -X GET http://192.168.26.82:30066/api/v2/hosts/ -s -k --user devops:devops | jq
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 8,
"type": "host",
"url": "/api/v2/hosts/8/",
"related":
................
也可以通过 浏览地址的方式,通过接口文档地址调用,http://192.168.26.82:30066/api/
API 的一个常见用途是启动现有的作业模板。可以通过 API 中的名称或者作业ID来引用作业模板:
从 API 启动作业模板是分两个步骤完成的:
┌──[root@vms81.liruilongs.github.io]-[~]
└─$curl -X GET --user admin:tP59YoIWSS6NgCUJYQUG4cXXJIaIc7ci http://192.168.26.82:30066/api/v2/job_templates/"liruilong_job_template"// -s | jq
{
"id": 11,
"type": "job_template",
"url": "/api/v2/job_templates/11/",
.....
过滤出执行作业的相关接口
┌──[root@vms81.liruilongs.github.io]-[~]
└─$curl -X GET --user admin:tP59YoIWSS6NgCUJYQUG4cXXJIaIc7ci http://192.168.26.82:30066/api/v2/job_templates/"liruilong_job_template"// -s | jq | grep -m 1 launch
"launch": "/api/v2/job_templates/11/launch/",
使用 POST 方法访问它以启动该作业。
┌──[root@vms81.liruilongs.github.io]-[~]
└─$curl -X POST --user admin:tP59YoIWSS6NgCUJYQUG4cXXJIaIc7ci http://192.168.26.82:30066/api/v2/job_templates/11/launch/ -k -s | jq
{
"job": 72,
"ignored_fields": {},
"id": 72,
"type": "job",
"url": "/api/v2/jobs/72/",
查看作业的执行情况
┌──[root@vms81.liruilongs.github.io]-[~]
└─$curl -X GET --user admin:tP59YoIWSS6NgCUJYQUG4cXXJIaIc7ci http://192.168.26.82:30066/api/v2/jobs/72/ -k -s | jq
{
"id": 72,
"type": "job",
"url": "/api/v2/jobs/72/",
"related": {
"created_by": "/api/v2/users/1/",
"labels": "/api/v2/jobs/72/labels/",
"inventory": "/api/v2/inventories/2/",
通过 jq 获取状态字段的值,这里可以看到当前 作业 状态failed, 失败了。
┌──[root@vms81.liruilongs.github.io]-[~]
└─$curl -X GET --user admin:tP59YoIWSS6NgCUJYQUG4cXXJIaIc7ci http://192.168.26.82:30066/api/v2/jobs/72/ -k -s | jq .status
"failed"
┌──[root@vms81.liruilongs.github.io]-[~]
└─$
可以使用 Ansible Playbook 来启动作业模板,方法是使用 uri 模块来访问 AWX API。也可以从 AWX 中的作业模板运行该 playbook,并使用它将另一作业模板作为其任务之一来启动。
在 Playbook 中必须为 AWX 提供足够的凭据,以便作为拥有启动该作业的权限的用户进行身份验证:
这里为了方便在 playbook 中嵌入了用于向 AWX 服务器进行身份验证的用户名和密码。若要保护这些数据,应该使用 Ansible Vault 加密 playbook,或者将机密移到一个变量文件中,再使用 Ansible Vault加密该文件。
Red Hat Ansible Engine可以使用uri模块与提供任意HTTPAPl类型的服务进行交互,包括RESTfulAPl。
参数,用于指定连接到服务器的HTTP方法,支持以下值:
有两个相互排斥的参数来发送此信息:
body_format选项,用于控制接收服务返回的格式。此选项支持3中格式:raw,json和form-urlencoded。对于RESTAPI,请使用json;对于基于表单的传统页面,请使用form-urlencoded。示例:
- name: Login to a form-based webpage
uri:
url: https://example.com/login.php
method: POST
body_format: form-urlencoded
body:
name: your_username
password: your_password
enter: Sign in
任何HTTP服务都会返回响应状态码信息。使用status_code选项将您期望成功的状态码告诉uri模块。如果响应中的状态码不同,则任务将失败。
- name: Login to a form-based webpage
uri:
url: https://example.com/login.php
status_code: 200
您必须处理响应本身:
一个Demo,这里用于获取当前的用户信息
┌──[root@vms81.liruilongs.github.io]-[~/ansible]
└─$cat api.yaml
---
- hosts: localhost
tasks:
- name: get job-template
uri:
# url: http://192.168.26.82:30066/api/v2/job_templates/11/
url: http://192.168.26.82:30066/api/v2/users/
method: GET
user: admin
password: tP59YoIWSS6NgCUJYQUG4cXXJIaIc7ci
validate_certs: False
force_basic_auth: true
return_content: true
register: awx_api_result
- debug:
var: awx_api_result
- name: Print job
debug:
msg: "{{ item['username'] }}"
loop: "{{ awx_api_result['json']['results'] }}"
《DO447 Advanced Automation Ansible Best Practices》
如果觉得我的文章对您有用,请点赞。您的支持将鼓励我继续创作!
赞3
添加新评论0 条评论