DragonFly On-Line Manual Pages

Search: Section:  


ANSIBLE-GALAXY(1)	System administration commands	     ANSIBLE-GALAXY(1)

NAME

ansible-galaxy - None

SYNOPSIS

ansible-galaxy [delete|import|info|init|install|list|login|remove|search|setup] [--help] [options] ...

DESCRIPTION

command to manage Ansible roles in shared repostories, the default of which is Ansible Galaxy https://galaxy.ansible.com.

COMMON OPTIONS

--list List all of your integrations. --remove REMOVE_ID Remove the integration matching the provided ID value. Use --list to see ID values. --version show program's version number and exit -c, --ignore-certs Ignore SSL certificate validation errors. -h, --help show this help message and exit -s API_SERVER, --server API_SERVER The API server destination -v, --verbose verbose mode (-vvv for more, -vvvv to enable connection debugging)

ACTIONS

info prints out detailed information about an installed role as well as info available from the galaxy API. --offline Don't query the galaxy API when creating roles -p, --roles-path The path to the directory containing your roles. The default is the roles_path configured in your ansible.cfgfile (/usr/local/etc/ansible/roles if not configured) search searches for roles on the Ansible Galaxy server -p, --roles-path The path to the directory containing your roles. The default is the roles_path configured in your ansible.cfgfile (/usr/local/etc/ansible/roles if not configured) --author AUTHOR GitHub username --galaxy-tags GALAXY_TAGS list of galaxy tags to filter by --platforms PLATFORMS list of OS platforms to filter by setup Setup an integration from Github or Travis for Ansible Galaxy roles --list List all of your integrations. --remove REMOVE_ID Remove the integration matching the provided ID value. Use --list to see ID values. list lists the roles installed on the local system or matches a single role passed as an argument. -p, --roles-path The path to the directory containing your roles. The default is the roles_path configured in your ansible.cfgfile (/usr/local/etc/ansible/roles if not configured) 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.cfgfile (/usr/local/etc/ansible/roles if not configured) init creates the skeleton framework of a role that complies with the galaxy metadata format. --offline Don't query the galaxy API when creating roles -f, --force Force overwriting an existing role --container-enabled Initialize the skeleton role with default contents for a Container Enabled role. --init-path INIT_PATH The path in which the skeleton role will be created. The default is the current working directory. --role-skeleton ROLE_SKELETON The path to a role skeleton that the new role should be based upon. install uses the args list of roles to be installed, unless -f was specified. The list of roles can be a name (which will be downloaded via the galaxy API and github), or it can be a local .tar.gz file. -n, --no-deps Don't download roles listed as dependencies -f, --force Force overwriting an existing role -i, --ignore-errors Ignore errors and continue with the next specified role. -p, --roles-path The path to the directory containing your roles. The default is the roles_path configured in your ansible.cfgfile (/usr/local/etc/ansible/roles if not configured) -r ROLE_FILE, --role-file ROLE_FILE A file containing a list of roles to be imported import used to import a role into Ansible Galaxy --status Check the status of the most recent import request for given github_user/github_repo. --no-wait Don't wait for import results. --branch REFERENCE The name of a branch to import. Defaults to the repository's default branch (usually master) --role-name ROLE_NAME The name the role should have, if different than the repo name login 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. delete Delete a role from Ansible Galaxy.

ENVIRONMENT

The following environment variables may be specified. ANSIBLE_CONFIG -- Override the default ansible config file Many more are available for most options in ansible.cfg

FILES

/usr/local/etc/ansible/ansible.cfg -- Config file, used if present ~/.ansible.cfg -- User config file, overrides the default config if present

AUTHOR

Ansible was originally written by Michael DeHaan. See the AUTHORS file for a complete list of contributors.

COPYRIGHT

Copyright (C) 2017 Red Hat, Inc | Ansible. Ansible is released under the terms of the GPLv3 License.

SEE ALSO

ansible(1), ansible-config(1), ansible-console(1), ansible-doc(1), ansible-inventory(1), ansible-playbook(1), ansible-pull(1), ansible-vault(1) Extensive documentation is available in the documentation site: http://docs.ansible.com. IRC and mailing list info can be found in file CONTRIBUTING.md, available in: https://github.com/ansible/ansible Ansible 2.4.2.0 11/29/2017 ANSIBLE-GALAXY(1)

Search: Section: