AI 助理
文档备案控制台
开发者社区 开发与运维 文章 正文

Ansible最佳实践之 AWX 使用 Ansible 与 API 通信

2022-12-18 942
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 写在前面分享一些 AWX 使用 Ansible 与 API 通信的笔记博文内容涉及：curl 方式调用 AWX API浏览器接口文档方式调用 AWX API使用 API 调用方式启动 AWX 中 作业模板Ansible 模块 uri 的简单介绍Ansible 剧本方式 调用 API 启动作业模板理解不足小伙伴帮忙指正

写在前面

  • 分享一些 AWX 使用 Ansible 与 API 通信的笔记

  • 博文内容涉及：

    • curl 方式调用 AWX API
    • 浏览器接口文档方式调用 AWX API
    • 使用 API 调用方式启动 AWX 中 作业模板
    • Ansible 模块 uri 的简单介绍
    • Ansible 剧本方式 调用 API 启动作业模板
  • 理解不足小伙伴帮忙指正

傍晚时分，你坐在屋檐下，看着天慢慢地黑下去，心里寂寞而凄凉，感到自己的生命被剥夺了。当时我是个年轻人，但我害怕这样生活下去，衰老下去。在我看来，这是比死亡更可怕的事。--------王小波

API 简单介绍

红帽 AWX 提供了一个类似 Swagger 的 RESTful 风格的 Web 服务框架，可以和 awx 直接交互。使管理员和开发人员能够在 web UI之外控制其 AWX 环境。

可以使用自定义脚本或外部应用使用标准HTTP消息访问API。尤其一些 devops 的联动、钩子相关的处理，REST API 的优势之一在于，任何支持 HTTP 协议的编程语言、框架或系统都可以使用API。这提供了一种简单的方式来自动化重复性任务，并将其他企业IT系统与 AWX 集成。

REST架构在客户端和服务器之间提供了无状态通信通道。每个客户端请求的行为都独立于任何其他请求，并且包含完成该请求所需的所有信息。

命令行curl的方式调用

请求使用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 的一个常见用途是启动现有的作业模板。可以通过 API 中的名称或者作业ID来引用作业模板：

从 API 启动作业模板是分两个步骤完成的：

  • 使用 GET 方法访问它，以获取有关启动该作业所需的任何参数或数据的信息。
┌──[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 中的 API 启动作业

可以使用 Ansible Playbook 来启动作业模板，方法是使用 uri 模块来访问 AWX API。也可以从 AWX 中的作业模板运行该 playbook，并使用它将另一作业模板作为其任务之一来启动。

在 Playbook 中必须为 AWX 提供足够的凭据，以便作为拥有启动该作业的权限的用户进行身份验证：

这里为了方便在 playbook 中嵌入了用于向 AWX 服务器进行身份验证的用户名和密码。若要保护这些数据，应该使用 Ansible Vault 加密 playbook，或者将机密移到一个变量文件中，再使用 Ansible Vault加密该文件。

uri模块与APl交互

Red Hat Ansible Engine可以使用uri模块与提供任意HTTPAPl类型的服务进行交互，包括RESTfulAPl。

参数，用于指定连接到服务器的HTTP方法，支持以下值：

  • GET，从URL标识的服务中获取实体信息，这是默认值。
  • POST，要求服务将实体信息存储在URL标识的资源下。
  • UT，要求服务将实体信息存储为URL标识的资源，如果存在则对其进行修改。
  • DELETE，删除服务中URL标识的实体。
  • PATCH，使用主体中的值修改请求URL所标识的实体。正文中只能有修改的值。

向API发送信息

有两个相互排斥的参数来发送此信息：

  • src选项，指向一个文件，该文件包含要发出的HTTP请求的正文。
  • body选项，以YAML格式定义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

处理API响应

任何HTTP服务都会返回响应状态码信息。使用status_code选项将您期望成功的状态码告诉uri模块。如果响应中的状态码不同，则任务将失败。

- name: Login to a form-based webpage 
  uri:
    url: https://example.com/login.php 
    status_code: 200

您必须处理响应本身：

  • 如果要将响应另存为文件，请使用dest选项指定。
  • 如果要在剧本中使用响应，请使用return_content选项将响应的正文添加到结果中，并将其保存在register变量中。

一个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》

文章标签：
Devops
Linux
数据安全/隐私保护
网络架构
API
数据格式
存储
JSON
关键词：
API最佳实践
API通信
最佳实践API
Ansible api
ansible API通信
山河已无恙
目录
相关文章
fzqoetf642qao
|
6月前
|
监控 安全 API
电商API安全最佳实践：保护用户数据免受攻击
在电商领域，API是连接用户、商家和支付系统的核心枢纽，但也常成为黑客攻击目标。本文系统介绍电商API安全的最佳实践，涵盖HTTPS加密、强认证授权、输入验证、速率限制、日志监控、安全审计及数据加密等关键措施，帮助您有效防范数据泄露与攻击风险，保障业务安全稳定运行。
fzqoetf642qao
253 0
aliyun9170107523-43660
|
3月前
|
存储 监控 安全
132_API部署：FastAPI与现代安全架构深度解析与LLM服务化最佳实践
在大语言模型(LLM)部署的最后一公里，API接口的设计与安全性直接决定了模型服务的可用性、稳定性与用户信任度。随着2025年LLM应用的爆炸式增长，如何构建高性能、高安全性的REST API成为开发者面临的核心挑战。FastAPI作为Python生态中最受青睐的Web框架之一，凭借其卓越的性能、强大的类型安全支持和完善的文档生成能力，已成为LLM服务化部署的首选方案。
aliyun9170107523-43660
820 3
油梨子
|
5月前
|
人工智能 JSON 前端开发
Mock 在 API 研发中的痛点、价值与进化及Apipost解决方案最佳实践
在 API 开发中，Mock 技术能有效解决后端接口未就绪带来的开发阻碍，保障前端独立高效开发。本文通过电商平台支付接口的实例，分析了常见 Mock 方案的局限性，并深入介绍了 Apipost 提供的灵活 Mock 能力：从固定值返回，到使用内置函数生成动态数据，再到自定义函数处理复杂逻辑，最后实现根据请求参数返回不同响应。这些能力不仅提升了开发效率，也增强了测试的全面性，为前后端协作提供了更高效的解决方案。
油梨子
313 3
fzqoetf642qao
|
7月前
|
存储 监控 安全
电商API安全指南：保护数据与防止欺诈的最佳实践
在电商领域，API安全至关重要。本文从基础到实践，全面解析电商API安全策略：通过强认证、数据加密、输入验证及访问控制保护敏感数据；借助速率限制、欺诈检测与行为分析防范恶意行为。同时，强调将安全融入开发生命周期，并提供应急计划。遵循最佳实践，可有效降低风险，增强用户信任，助力业务稳健发展。
fzqoetf642qao
251 4
兵临天下19970108016
|
6月前
|
存储 安全 NoSQL
【干货满满】API安全加固指南：签名防篡改+Access Token管理最佳实践
API 安全关乎业务与用户隐私，签名机制防篡改、伪造请求，Access Token 管理身份与权限。本文详解签名生成、Token 类型与管理、常见安全问题及最佳实践，助开发者构建安全可靠的 API 体系。
兵临天下19970108016
778 0
数据库知识学习者
|
9月前
|
人工智能 运维 关系型数据库
云服务API与MCP深度集成，RDS MCP最佳实践
近日，阿里云数据库RDS发布开源RDS MCP Server，将复杂的技术操作转化为自然语言交互，实现"对话即运维"的流畅体验。通过将RDS OpenAPI能力封装为MCP协议工具，用户只需像聊天一样描述需求，即可完成数据库实例创建、性能调优、故障排查等专业操作。本文介绍了RDS MCP（Model Context Protocol）的最佳实践及其应用，0代码，两步即可轻松完成RDS实例选型与创建，快来体验！
数据库知识学习者
1230 3
云服务API与MCP深度集成，RDS MCP最佳实践
游客mass6jalwg5qm
|
9月前
|
JSON 测试技术 API
书写API文档的最佳实践📚
API文档对开发者体验和API成功至关重要。本文探讨了编写清晰、全面且友好的API文档的最佳实践，包括定义API目的、结构化文档、提供代码示例、处理错误、版本控制及测试验证等关键步骤。通过实际案例（如WeatherAPI），展示了如何优化文档内容，帮助开发者快速上手并高效使用API。同时强调交互式功能、国际化支持和用户反馈的重要性，以提升文档的可用性和全球可达性。高质量文档不仅能推动API采用率，还能培养强大的开发者社区，为API的长期成功奠定基础。
游客mass6jalwg5qm
289 11
技术内容小助手
|
弹性计算 监控 安全
API稳定安全最佳实践:用阿里云SDK为业务保驾护航
阿里云智能集团高级技术专家赵建强和曹佩杰介绍了API稳定安全最佳实践，涵盖业务上云真实案例、集成开发最佳实践、配额管理和共担模型四部分。通过分析企业在不同阶段遇到的问题，如签名报错、异常处理不严谨、扩容失败等，提出了解决方案和工具，确保API调用的安全性和稳定性。特别强调了SDK的使用、无AK方案、自动刷新机制以及配额中心的作用，帮助用户构建更稳定、安全的服务，提升运维效率。最终介绍了集成开发共担模型，旨在通过最佳实践和平台工具，保障业务的稳定与安全，推动行业创新与发展。
技术内容小助手
389 12
大数据文摘
|
存储 安全 Java
Spring Boot 编写 API 的 10条最佳实践
本文总结了 10 个编写 Spring Boot API 的最佳实践，包括 RESTful API 设计原则、注解使用、依赖注入、异常处理、数据传输对象（DTO）建模、安全措施、版本控制、文档生成、测试策略以及监控和日志记录。每个实践都配有详细的编码示例和解释，帮助开发者像专业人士一样构建高质量的 API。
大数据文摘
493 9
WBKJ_Noah18870292986
|
监控 数据管理 测试技术
API接口自动化测试深度解析与最佳实践指南
本文详细介绍了API接口自动化测试的重要性、核心概念及实施步骤，强调了从明确测试目标、选择合适工具、编写高质量测试用例到构建稳定测试环境、执行自动化测试、分析测试结果、回归测试及集成CI/CD流程的全过程，旨在为开发者提供一套全面的技术指南，确保API的高质量与稳定性。
WBKJ_Noah18870292986
738 4