Skip to content

Commit adaae1b

Browse files
committed
updated readme
1 parent 3139a82 commit adaae1b

1 file changed

Lines changed: 11 additions & 9 deletions

File tree

README.md

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ See our [dev guide](https://devguide.quali.com/configmanagement/2020.1.0/cf-ansi
1212

1313
## Gitlab Support
1414
- Gitlab links are supported, but for Private Repos require the URL to be in format of their REST api
15-
- http://<SERVER_IP>/api/<API_VERSION>/projects/<PROJECT_ID>/repository/files/<PROJECT_PATH>/raw?ref=<GIT_BRANCH>
15+
- `http://<SERVER_IP>/api/<API_VERSION>/projects/<PROJECT_ID>/repository/files/<PROJECT_PATH>/raw?ref=<GIT_BRANCH>`
1616
- example - http://10.160.7.7/api/v4/projects/4/repository/files/hello_world.yml/raw?ref=master
1717
- The password field needs to be populated with gitlab access token, which will be sent along with request as header
1818
- Access Token only needed for private repos, password field can be left blank for public repos
@@ -50,14 +50,14 @@ This service shell uses the same python package as the 1G shell.
5050
|Playbook URL Full|String|Full path URL of script. For Github can be "raw" url. For gitlab, pass Rest API formatted url. Populate either this or base path + script path|
5151
|Playbook Base Path|String|Base URL to script. This path will join with script path passed to execute playbook command.|
5252
|Playbook Script Path|String|Path to script from root of repo. This will join with base path to create full URL.|
53-
|Connection Method|String|For Linux / Windows connections|
53+
|Connection Method|String|Lookup values \[SSH, WinRM\] - For Linux / Windows connections|
5454
|Address|String|**(Optional)** Address of Script Repo Server. Can be useful to see this on component or generate web link.|
5555
|Repo User|String|**(Optional)** Source Control user for private repo authentication. Required for Github Private Repo. For Gitlab user not required, only access token in password field.|
5656
|Repo Password|Password|**(Optional)** Source Control password for private repo authentication. For GitLab, add private access token here.|
57-
|Script Parameters|String|**(Optional)** key pair values passed playbook VARS file to be accesible in script. Pass in following format - key1,val1;key2,val2.|
58-
|Inventory Groups|String|**(Optional)** Designating groups in playbook to be executed.|
59-
|Ansible CMD Args|String|**(Optional)** Additional arguments passed to ansible-playbook command line execution.|
60-
|Timeout Minutes|Integer|**(Optional)** Minutes to wait while polling target hosts. (Defaults to 10)|
57+
|Script Parameters|String|**(Optional)** Variables accessible to playbook. These are populated in ansible "VARS" file. Pass in following format - key1,val1;key2,val2.|
58+
|Inventory Groups|String|**(Optional)** Designating groups in playbook to be executed. See Dev guide for mor info.|
59+
|Ansible CMD Args|String|**(Optional)** Additional arguments appended to ansible-playbook command line execution. Pass full string(ex. `ansible-playbook -i hosts.ini <ANSIBLE CMD ARGS>`|
60+
|Timeout Minutes|Integer|**(Optional)** Minutes to wait while polling target hosts. Default - 10|
6161
|Gitlab Branch|String|**(Optional)** Defaults to master branch. This attribute relevant for downloading from non-master branches in Gitlab repos.|
6262

6363
## Commands
@@ -72,6 +72,7 @@ There are a few ways to pass the playbook path to the command.
7272
2. Pass playbook path (relative to root of repo) to command. This will join together with base path attribute on service.
7373
3. Pass no command input, will fall back to Repo Full URL if populated, if not populated will fall back to base repo + script path attributes on service.
7474

75+
Note: - `/raw?ref=<GIT_BRANCH>` can be left off url path for Gitlab URL on 2G shell, the shell will add this
7576

7677
## Over-riding Service with Resource Attributes
7778
The service by default will "broadcast it's attributes to all connected resources.
@@ -83,11 +84,12 @@ The following attributes are supported for over-ride:
8384
- "Script Parameters" - String - to pass different params to different hosts
8485
- "Inventory Groups" - String - target different inventory group logic for different hosts
8586

86-
## Optional
87+
## Optional Implementations
8788
- Add "Supports Ansible" Execution Server Selector. This is the same selector that 1G service uses to define your pools of servers that will run script.
8889
- can be combinded with standard selector to further define your selectors per service
89-
- Create web link to script server by adding the following to UniversalSettings.xml on Quali Server:
90-
- `<key name="Web Link" pattern="http://{Address}" `
90+
- Create web link to script server by adding the following to UniversalSettings.xml on Quali Server and populating `Address` attribute on service:
91+
- `<key name="Web Link" pattern="http://{Address}" icon-key="Web"/>`
92+
9193

9294
## Changelog
9395
- 25/12/2020 - Added Gitlab Support & Parameter Over-rides

0 commit comments

Comments
 (0)