# Contributor guide

Receptor is an open source project that lives at https://github.com/ansible/receptor

## Code of conduct

All project contributors must abide by the Ansible Code of Conduct.

## Contributing

Receptor welcomes community contributions! See the Developer guide for details.

## Release process

Maintainers have the ability to run the Stage Release workflow. Running this workflow will:

- Build and push the container image to ghcr.io. This serves as a staging environment where the image can be tested.

- Create a draft release at https://github.com/ansible/receptor/releases

After the draft release has been created, edit it and populate the description. Once you are done, click “Publish release”.

After the release is published, the Promote Release workflow will run automatically. This workflow will:

- Publish receptorctl to PyPI.

- Pull the container image from ghcr.io, re-tag, and push to Quay.io.

- Build binaries for various OSes/platforms, and attach them to the release.

Note

If you need to re-run Stage Release more than once you must delete the tag beforehand, otherwise the workflow will fail.