ansible-galaxy
Description
command to manage Ansible roles in shared repositories, the default of which is Ansible Galaxy .
Common Options
—remove
<REMOVE_ID>
- Remove the integration matching the provided ID value. Use –list to see ID values.
-c
,
—ignore-certs
- Ignore SSL certificate validation errors.
- show this help message and exit
-v
,
—verbose
- verbose mode (-vvv for more, -vvvv to enable connection debugging)
Delete a role from Ansible Galaxy.
import
used to import a role into Ansible Galaxy
—branch
<REFERENCE>
- The name of a branch to import. Defaults to the repository’s default branch (usually master)
—no-wait
- Don’t wait for import results.
—status
- Check the status of the most recent import request for given github_user/github_repo.
info
prints out detailed information about an installed role as well as info available from the galaxy API.
-p
—roles-path
- The path to the directory containing your roles. The default is the roles_path configured in your ansible.cfg file (/etc/ansible/roles if not configured)
creates the skeleton framework of a role that complies with the galaxy metadata format.
—init-path
<INIT_PATH>
- The path in which the skeleton role will be created. The default is the current working directory.
—offline
- Don’t query the galaxy API when creating roles
—type
<ROLE_TYPE>
- Initialize using an alternate role type. Valid types include: ‘container’, ‘apb’ and ‘network’.
install
uses the args list of roles to be installed, unless -f was specified. The list of rolescan be a name (which will be downloaded via the galaxy API and github), or it can be a local .tar.gz file.
- Force overwriting an existing role
-g
,
—keep-scm-meta
- Use tar instead of the scm archive option when packaging the role
-n
,
—no-deps
- Don’t download roles listed as dependencies
-p
—roles-path
- The path to the directory containing your roles. The default is the roles_path configured in your ansible.cfg file (/etc/ansible/roles if not configured)
-r
<ROLE_FILE>
,
—role-file
<ROLE_FILE>
- A file containing a list of roles to be imported
list
-p
,
—roles-path
- The path to the directory containing your roles. The default is the roles_path configured in your ansible.cfg file (/etc/ansible/roles if not configured)
verify user’s identify via Github and retrieve an auth token from Ansible Galaxy.
—github-token
<TOKEN>
- Identify with github token rather than username and password.
remove
removes the list of roles passed as arguments from the local system.
-p
,
—roles-path
- The path to the directory containing your roles. The default is the roles_path configured in your ansible.cfg file (/etc/ansible/roles if not configured)
search
searches for roles on the Ansible Galaxy server
—author
<AUTHOR>
- GitHub username
—platforms
<PLATFORMS>
- list of OS platforms to filter by
-p
,
—roles-path
- The path to the directory containing your roles. The default is the roles_path configured in your ansible.cfg file (/etc/ansible/roles if not configured)
Setup an integration from Github or Travis for Ansible Galaxy roles
—list
- List all of your integrations.
- Remove the integration matching the provided ID value. Use –list to see ID values.
Environment
The following environment variables may be specified.
ANSIBLE_CONFIG
– Override the default ansible config file
Files
/etc/ansible/ansible.cfg
– Config file, used if present
~/.ansible.cfg
– User config file, overrides the default config if present
Ansible was originally written by Michael DeHaan.
See the AUTHORS file for a complete list of contributors.
Copyright
Copyright © 2017 Red Hat, Inc | Ansible.
Ansible is released under the terms of the GPLv3 License.