forked from microsoft/azure-pipelines-extensions
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Enabling Ansible task for Deployment Group and merging master to rele…
…ase (microsoft#633) * Create SampleServiceBusMessageBody.txt * Standard change request type added * test changes removed * task updated * Task updated * GroupName removed * Create CR task updated * Output variables added * Removing unused image files from Ansible extension. (microsoft#590) * Output variable updated and dataSource of impact changed (microsoft#584) * LOC CHECKIN | Microsoft/vsts-rm-extensions master | 20190213 (microsoft#591) * Fixing the disabled Ansible tests and enabling them (microsoft#592) Fixing the disabled Ansible tests and enabling them. * fixes done * Task updated * Review changes done and readme updated * Usage of scripted REST api is reverted * Adding the documentation on partial download of custom artifacts (microsoft#599) * review changes done * V1 version task added for back compat * Publisher name and TestConnection major required version updated * Move CircleCI extensions to Marketplace - Part 2 (microsoft#598) * Move CircleCI artifact to Extension * Changed the URL to query active standard templates * Update readme.md (microsoft#603) * Update readme.md (microsoft#604) * Update readme.md * Update task.json * Update mp_terms.md * Update mp_terms.md * Update mp_terms.md * Update mp_terms.md * Update mp_terms.md * Update ThirdPartyNotices.txt * Update ThirdPartyNotices.txt * Update ThirdPartyNotices.txt * Update vss-extension.json * Update readme.md * Update resources.resjson * Update README.md * Update readme.md * fix icon issues (microsoft#601) * Use latest version of azure-pipelines-task-lib (microsoft#602) * Update dataSources.md * Added telemetry for SQL dacpac deploy task (microsoft#600) * Query by Correlation Id is removed and other minor bug fixes * public is set to true * Support for updating existing change request in gate is added * Passing correlation_id in V2 tasks to support back compat for some cases * Correlation Id output variable fixed * Move Jenkins test data to new server (microsoft#607) * Update PartialArtifactsDownload.md (microsoft#610) * handle encoding issue for powershell legacy handlers based iis web extension tasks (microsoft#611) * updated circle-ci extension id and endpoint contribution ID (microsoft#612) * The name of the extension has a spelling error * refactored extension's name from circlci to circleci * Check state of app pool (microsoft#615) * Check state of app pool * Fixed test cases * Review comment * Updated readme to include feed location (microsoft#619) * [Security] Bump extend from 3.0.1 to 3.0.2 (microsoft#620) Bumps [extend](https://github.com/justmoon/node-extend) from 3.0.1 to 3.0.2. **This update includes security fixes.** - [Release notes](https://github.com/justmoon/node-extend/releases) - [Changelog](https://github.com/justmoon/node-extend/blob/master/CHANGELOG.md) - [Commits](justmoon/node-extend@v3.0.1...v3.0.2) * Adding documentation for default version types for artifact contribution (microsoft#469) * [Security] Bump tar from 4.4.1 to 4.4.8 (microsoft#622) Bumps [tar](https://github.com/npm/node-tar) from 4.4.1 to 4.4.8. **This update includes security fixes.** - [Release notes](https://github.com/npm/node-tar/releases) - [Commits](isaacs/node-tar@v4.4.1...v4.4.8) * Missing curly brackets The template variables for data source endpoints etc. require three curly brackets, not just two. (See also e.g. the `AzureResourceGroups` data source in https://docs.microsoft.com/en-us/rest/api/vsts/serviceendpoint/types/list?view=vsts-rest-4.1#examples . * Update README_IISAppMgmt.md (microsoft#624) * fix: Extensions/Ansible/Src/readme.md - Trim trailing/leading spaces - Remove extra bold from titles * Enabling Ansible task for Deployment Group as well * Updated Ansible extension version * Update README_IISAppMgmt.md (microsoft#629) * Updated version of Ansible task * Hiding password (microsoft#631) * Hiding password * Fixing indentation * Changing extension * Enabling Ansible task for Deployment Group as well (microsoft#628) * Enabling Ansible task for Deployment Group as well * Updated Ansible extension version * Updated version of Ansible task * Add Canada Central region For the #gdbc we need to run Twitter Sentiment Analysis in Canada Central. Would love to have this added quickly! * Changed cognitiveServicesEndpointRegion input picklist to editable picklist. (microsoft#635) Update the extension version.
- Loading branch information
1 parent
345108f
commit 4ed0f9d
Showing
108 changed files
with
2,880 additions
and
845 deletions.
There are no files selected for viewing
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,65 +1,70 @@ | ||
# **Ansible extension** | ||
# Ansible extension | ||
|
||
This extension includes a build/release task to integrate with [Ansible](http://docs.ansible.com/ansible/latest/index.html). The task executes a given Ansible playbook on a specified list of inventory nodes via command line interface. | ||
Ansible is an open-source IT automation engine that can configure systems, deploy software and orchestrate application deployments. | ||
Ansible uses [Playbooks](http://docs.ansible.com/ansible/latest/playbooks.html) which express configurations, deployment, and orchestration steps in YAML format. Each Playbook maps a group of hosts to a set of roles. Each role is represented by calls to Ansible tasks. | ||
[Inventory](http://docs.ansible.com/ansible/latest/intro_inventory.html) file is a description of the nodes that can be accessed by Ansible. | ||
Ansible is an open-source IT automation engine that can configure systems, deploy software and orchestrate application deployments. | ||
Ansible uses [Playbooks](http://docs.ansible.com/ansible/latest/playbooks.html) which express configurations, deployment, and orchestration steps in YAML format. Each Playbook maps a group of hosts to a set of roles. Each role is represented by calls to Ansible tasks. | ||
[Inventory](http://docs.ansible.com/ansible/latest/intro_inventory.html) file is a description of the nodes that can be accessed by Ansible. | ||
|
||
This task requires that the Playbook and Inventory files be located either on a private Linux agent or on a remote machine where Ansible automation engine has been installed. Additionally Inventory can also be specified inline or as a Host list. | ||
|
||
## **Prerequisites** | ||
## Prerequisites | ||
|
||
### Install Ansible automation engine | ||
|
||
### **Install Ansible automation engine** | ||
Follow the [installation guidance](http://docs.ansible.com/ansible/latest/intro_installation.html) to install Ansible on a private Linux agent or on a remote machine. Currently Ansible can be run from any machine with Python 2.6 or 2.7 installed (Windows isn’t supported for the control machine). | ||
|
||
### **Create an SSH endpoint** | ||
|
||
### Create an SSH endpoint | ||
|
||
If Ansible is installed on a remote machine, you would need to set up an [SSH endpoint](https://www.visualstudio.com/en-us/docs/build/concepts/library/service-endpoints#sep-ssh) in the administration section of your VSTS project. | ||
- The hostname or IP address of the remote machine, the port number, and the user name are required | ||
- The private key and the passphrase must be specified for authentication. | ||
- A password can be used to authenticate to remote Linux machines, but this is not supported for Mac or OSX systems. | ||
|
||
- The hostname or IP address of the remote machine, the port number, and the user name are required | ||
- The private key and the passphrase must be specified for authentication. | ||
- A password can be used to authenticate to remote Linux machines, but this is not supported for Mac or OSX systems. | ||
- The public key must be pre-installed or copied to the remote machine. | ||
|
||
![Ansible SSH Endpoint](Images/ansible_endpoint.png) | ||
|
||
## **Task** | ||
|
||
![Ansible SSH Endpoint](Images/ansible_endpoint.png) | ||
|
||
## Task | ||
|
||
Installing the extension adds the following Ansible task which runs a given Playbook: | ||
|
||
When Ansible automation engine is located on an Agent machine: | ||
![Run Ansible Playbook](Images/ansible_screen_1.png) | ||
|
||
![Run Ansible Playbook](Images/ansible_screen_1.png) | ||
|
||
When Ansible automation engine is located on a remote machine: | ||
|
||
![Run Ansible Playbook](Images/ansible_screen_2.png) | ||
|
||
## Task arguments | ||
|
||
* **Ansible location**: Location where Ansible automation engine is installed. Can be either a private agent machine or a remote machine. Ansible communicates with remote machines over SSH and would require the SSH endpoint details. | ||
|
||
When Ansible automation engine is located on a remote machine: | ||
![Run Ansible Playbook](Images/ansible_screen_2.png) | ||
* **SSH endpoint**\*: Name of the SSH service endpoint containing connection details for the remote machine where Ansible automation engine has been installed. | ||
|
||
## **Task arguments** | ||
|
||
* **Ansible location**: Location where Ansible automation engine is installed. Can be either a private agent machine or a remote machine. Ansible communicates with remote machines over SSH and would require the SSH endpoint details. | ||
|
||
* **SSH endpoint**\*: Name of the SSH service endpoint containing connection details for the remote machine where Ansible automation engine has been installed. | ||
* **Playbook Source**: Choose agent machine if playbook is part of a linked artifact and should be copied to the remote Ansible machine. Otherwise, select Ansible machine. | ||
|
||
* **Playbook Source**: Choose agent machine if playbook is part of a linked artifact and should be copied to the remote Ansible machine. Otherwise, select Ansible machine. | ||
* **Playbook root**\*: Specify the working directory path where playbook and associated files are located on the agent machine. All the files in this folder will be copied to Ansible machine. | ||
|
||
* **Playbook root**\*: Specify the working directory path where playbook and associated files are located on the agent machine. All the files in this folder will be copied to Ansible machine. | ||
* **Playbook file path**\*: Specify the path to the playbook file to be executed on the Ansible machine. [Playbooks](http://docs.ansible.com/ansible/latest/playbooks.html) declare Ansible’s configuration, deployment, and orchestration steps in YAML format. | ||
|
||
* **Playbook file path**\*: Specify the path to the playbook file to be executed on the Ansible machine. [Playbooks](http://docs.ansible.com/ansible/latest/playbooks.html) declare Ansible’s configuration, deployment, and orchestration steps in YAML format. | ||
* **Inventory location**: By default, Ansible Inventory is described by a configuration file, in INI format, whose default location is in /etc/ansible/hosts. Inventory can also be specified as a separate configuration file which lists either the IP address or hostname of each node that is accessible by Ansible. Or can be specified as a Host list of comma separated hosts. Example - foo.example.com, bar.example.com. | ||
|
||
* **Inventory location**: By default, Ansible Inventory is described by a configuration file, in INI format, whose default location is in /etc/ansible/hosts. Inventory can also be specified as a separate configuration file which lists either the IP address or hostname of each node that is accessible by Ansible. Or can be specified as a Host list of comma separated hosts. Example - foo.example.com, bar.example.com. | ||
Alternatively Inventory can be specified inline. | ||
|
||
* **Inventory file path**\*: Specify the path to [inventory](http://docs.ansible.com/ansible/latest/intro_inventory.html) host file on Ansible/Agent machine | ||
* **Inventory file path**\*: Specify the path to [inventory](http://docs.ansible.com/ansible/latest/intro_inventory.html) host file on Ansible/Agent machine | ||
|
||
* **Dynamic Inventory**: Ansible can also use a custom Dynamic Inventory script, which can dynamically pull data from a different system. Check this box if [dynamic inventory](http://docs.ansible.com/ansible/latest/intro_dynamic_inventory.html) is used. | ||
* **Dynamic Inventory**: Ansible can also use a custom Dynamic Inventory script, which can dynamically pull data from a different system. Check this box if [dynamic inventory](http://docs.ansible.com/ansible/latest/intro_dynamic_inventory.html) is used. | ||
|
||
* **Advanced - Sudo**: Run operations with sudo. It works only when the Ansible user is sudoer with nopasswd option. | ||
* **Advanced - Sudo**: Run operations with sudo. It works only when the Ansible user is sudoer with nopasswd option. | ||
This also requires desired sudo user name. \"root\" is used when this field is empty. | ||
|
||
* **Additional arguments**: The arguments to pass to Ansible command line. Refer to documentation on Ansible [Commands Modules](http://docs.ansible.com/ansible/latest/list_of_commands_modules.html) and [Ad-Hoc Commands](http://docs.ansible.com/ansible/latest/intro_adhoc.html) | ||
* **Additional arguments**: The arguments to pass to Ansible command line. Refer to documentation on Ansible [Commands Modules](http://docs.ansible.com/ansible/latest/list_of_commands_modules.html) and [Ad-Hoc Commands](http://docs.ansible.com/ansible/latest/intro_adhoc.html) | ||
|
||
* **Advanced - Fail on STDERR**: If this option is selected (the default), the build will fail if the remote commands or script write to STDERR. | ||
* **Advanced - Fail on STDERR**: If this option is selected (the default), the build will fail if the remote commands or script write to STDERR. | ||
|
||
* **Control options**: See [Control options](https://www.visualstudio.com/en-us/docs/build/concepts/process/tasks#controloptions) | ||
* **Control options**: See [Control options](https://www.visualstudio.com/en-us/docs/build/concepts/process/tasks#controloptions) | ||
|
||
### **Contact Information** | ||
### Contact Information | ||
|
||
For further information or to resolve issues, contact [Developer Community Forum](https://developercommunity.visualstudio.com/spaces/21/index.html). | ||
For further information or to resolve issues, contact [Developer Community Forum](https://developercommunity.visualstudio.com/spaces/21/index.html). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
1 change: 0 additions & 1 deletion
1
Extensions/ArtifactEngine/.nyc_output/cd19e711c15902ea1b399b7e15047d4f.json
This file was deleted.
Oops, something went wrong.
Oops, something went wrong.