Skip to content

Latest commit

 

History

History
155 lines (95 loc) · 6.19 KB

status.rst

File metadata and controls

155 lines (95 loc) · 6.19 KB

Ansible Collections Project Status

This page gives an overview

Warning: Subject to frequent updates
This is a "living document", expect it to change as we progress with the Collections work over the next few months.

For background on collections see Ansible Collections Overview.

# FIXME, can we say all collections from acd.in are good now?

A lot of the new Ansible Collection repos are open for contributions Most Collections aren't ready to be used yet, though you can start contributing to a few.

This section details the various deadlines and milestones which make up the Ansible release.

Ansible-base has it's own roadmap.

  • ansible-base 2.10 beta 1 (creation of ansible/ansible:stable-2.10)
  • All collections passing ansible-test sanity against ansible/ansible:stable-2.10
  • No more moving (claiming) content from communtiy.general or community.network into dedicated collections
  • Feature freeze for all collections (no more modules/plugins)
  • New ansible package for PyPi
  • new ansible package for rpm, deb,... (include externally maintained packages?)

Note, the order of the above items may change, also items may be added or removed

The following section details the remaining large blocks of work remaining before Ansible 2.10 can be released. Some of these item are proposals, or work in progress (WIP) Pull Requests. As Collections is a large change to development, community and end-users it's really important to us that

This PR to ansible-base is one of the key features to allow Ansible 2.9 playbooks work without modification in Ansible 2.10

Once this PR merged CI for the community.general collection repository should be a lot greener.

The main features it will provide are:

  • Modules and plugins to be reference by the "short form", ie mail rather than community.general.mail
  • Ability to have deprecated content in Collections via a meta/routing.yml file in a collection example

See ` collection redirection/tombstoning (#67684) <ansible/ansible#67684>`_ for a full list of features.

In Ansible 2.9 (and earlier) all modules and plugins were all packaged to gether, so a single version could be used. As collections can be released and versioned independently this is no longer true.

Versioning and deprecation proposal

ACD Proposal

FIXME: Link to proposal

Allows Collection owners to publish their Collection to Galaxy with ease.

The community.general is the largest collection we have. It has ~1,000 modules in.

For larger Collection repos we will need ansibulbot to help maintainers.

We expect ansibulbot to be needed on:

  • community.aws
  • community.general
  • community.network
  • community.windows

The bot is mostly functional, we need to do some more testing on it

  • We have a script which will help move PRs from ansible/ansible into the collection which hosts the code
  • Once the repos are stable we will auto close PRs in ansible/ansible
  • We don't have a good method to move Issues, these will stay in ansible/ansible for longer

The main pending documentation changes include:

The other documentation issues related to collections on docs.ansible.com are being tracked with the docs and collections labels.

This document is just a summary of the bigger todo items.

A list of items can be found in the Community Collection Project Board