# Ansible
添加该步骤可以在主机上执行您上传的playbook。
#### 约束限制
"Ansible"步骤目前仅对2025年8月30日前使用过此步骤的用户开放。
#### 配置部署步骤
1. 参考[新建应用](https://support.huaweicloud.com/usermanual-deployman/deployman_hlp_00004.html#deployman_hlp_00004__section1514163217456)，完成应用创建。
2. 根据业务场景，在"部署步骤"页面，添加该部署步骤。
3. 对步骤进行配置，详细参数配置如下所示。 
   表1参数说明 
   | 参数项             | 说明                                                                                                                                                                                                                                                                                                                                             |
   |:---|:---|
   | 步骤显示名称        | 步骤添加后在部署步骤显示的名称。仅支持汉字、英文字母、数字、空格、或-_,;:./()（）符号，其中空格不可在名称开头或结尾使用，长度为1-128。                                                                                                                                                                                                                                                                     |
   | 环境            | 选择当前资源类型为主机集群的环境，作为部署对象。                                                                                                                                                                                                                                                                                                                       |
   | 选择playbook来源 | 包括"制品仓库"和"代码仓库"两种来源。 - Playbook中template模块中文本文件必须是"UTF-8"编码。  - Playbook中如果有下载软件包的相关Task，务必注意避免下载包含中文名称的软件包，否则下载后的文件会出现乱码，导致其它相关应用执行失败。   |
   | 选择playbook文件 | 可以选择制品仓库已有playbook文件，也可以选择本地上传的playbook文件。 本地上传的软件包/文件会上传到制品仓库，可以重复使用。                                                                                                                                                                                                                                    |
   | 入口执行文件路径     | playbook入口执行文件的路径。                                                                                                                                                                                                                                                                                                                             |
   | 控制选项          | 配置是否启用以下操作。 - 失败后继续运行：当前步骤部署失败后，应用继续部署后续的步骤。                                                                                                                                                                              |
      
   
   
 
以下根据playbook来源详细介绍使用方法，包括制品仓库和代码仓库：
#### 制品仓库使用案例
1. 在应用步骤信息配置页面，"选择playbook来源"勾选"制品仓库"，单击"选择playbook文件"属性框右边的![](https://support.huaweicloud.com/usermanual-deployman/zh-cn_image_0000001507196953.png "点击放大")。
2. 弹出"选择文件"对话框，选择对应的playbook文件压缩包，如下图所示。 
   ![](https://support.huaweicloud.com/usermanual-deployman/zh-cn_image_0000001507276633.png "点击放大")
   
   
3. 填写playbook入口执行文件路径。
4. 入口执行文件路径以选择的playbook压缩包解压后的目录为基准。 
   - 如果解压后的目录如下图所示，则入口执行文件路径为"AnsibleDemo/install.yml"。 ![](https://support.huaweicloud.com/usermanual-deployman/zh-cn_image_0000001457516872.png)
     
   
   - 如果解压后的目录如下图所示，则入口执行文件路径为"install.yml"。 ![](https://support.huaweicloud.com/usermanual-deployman/zh-cn_image_0000001457197008.png)
     
   
   
   
   
 
#### 代码仓库使用案例
1. 在应用步骤信息配置页面，"选择playbook来源"勾选"代码仓库"。
2. 单击"选择代码仓库"属性下拉框，选择对应的代码仓库对应的地址（即代码仓库存放playbook具体的SSH URL地址）。
3. 需要先选择代码仓库，然后联动选择分支。
4. 选择入口执行文件路径。 
   入口执行文件路径以解压playbook包后的目录为基准。
   
   
5. 参数设置。 
   1. 切换到"参数设置"页签，单击"新建参数"，可以为Ansible应用步骤增加参数或者替换all文件参数。
      - 如果添加的参数在playbook参数all文件中存在，则会将all文件中的同名参数替换掉，否则会作为新增参数。
      
      - 参数设置中参数名称不能包含英文状态的"."（小数点）、"-"（中划线）和":"（冒号）。
       
   
   2. 部署应用后，会把相应构建序号的构建任务下载到指定的路径下。
      all文件的文件架构及内容样例如下：
      ```
      tomcat_url: http://mirror.olnevhost.net/pub/apache/tomcat/tomcat-7/v7.0.78/bin/apache-tomcat-7.0.78.tar.gz 
      war_url: http://test.com/xxx.war
      ```
      图1文件架构   
      ![](https://support.huaweicloud.com/usermanual-deployman/zh-cn_image_0000001634956041.png "点击放大") 
   
   
   
   
 
#### 相关文档
若在部署过程中遇到问题，可参考该步骤的[常见问题解决办法](https://support.huaweicloud.com/deployman_faq/deployman_faq_0015.html)。