ansible-community/Build an Ansible collection

This action builds an Ansible collection. The resulting artifact (tarball) can be used in other steps or uploaded as a GitHub artifact.

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Activelast commit Jun 22, 2026
License
GPL 3.0

Pinned Snippet

workflow.ymlSHA-pinned
uses: ansible-community/github-action-build-collection@0114c6cc7d519ac693d4f385750e1706321f6d56 # no releases — HEAD as of 2026-07-13

tags can be moved; commit SHAs can't. why a SHA?

namedescriptionrequireddefault
python-versionThe Python version to use for running ansible-core.3.13
ansible-core-versionThe branch of tag name of ansible-core to install. This is assumed to exist in https://github.com/ansible/ansible.stable-2.18
subdirectoryThe subdirectory in which the collection's sources can be found. Must contain the `galaxy.yml` file..
collection-requirements-pathIf provided, the collection's requirements will be written as a Galaxy `requirements.yml` file to this path.
namedescription
collection-full-nameThe collection's full name (namespace.name).
collection-nameThe collection's name. For example `ansible.posix`'s name is `posix`.
collection-namespaceThe collection's namespace. For example `ansible.posix`'s namespace is `ansible`.
collection-versionThe collection's version. Will be set to `0.0.1` if no `version` field is present in `galaxy.yml`.
artifact-filenameFilename of the built collection artifact.
artifact-pathPath to the built collection artifact.