Server IP : 85.214.239.14 / Your IP : 3.139.93.242 Web Server : Apache/2.4.62 (Debian) System : Linux h2886529.stratoserver.net 4.9.0 #1 SMP Tue Jan 9 19:45:01 MSK 2024 x86_64 User : www-data ( 33) PHP Version : 7.4.18 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, MySQL : OFF | cURL : OFF | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : OFF Directory : /proc/2/root/proc/3/root/lib/python3/dist-packages/ansible_collections/google/cloud/ |
Upload File : |
# Maintainer Documentation ## See CONTRIBUTING.md for more tasks [CONTRIBUTING.md](./CONTRIBUTING.md) contains more instructions that could apply to contributors and not just maintainers (e.g. update ansible-core version). ## CI GCP Project Configuration To enable running integration tests, a test GCP project must be provided. There is a Google-maintained CI project, `ansible-gcp-ci`, that is used for this purpose. For any questions or modification to this project, please contact a maintainer who is employed by Google. ## Reviewing PRs ### Merging PRs Since running the full set of integration tests requires the usage of GCP credentials which are stored as a secret, maintainers must verify that tests pass the integration test run that runs on push to the master branch after accepting a change. ## Release Process ### Overview The process is as follows: 1. Update the version of the collection. 1. Update the changelog. 2. Create a GitHub release to tag the repo and begin the publishing process. ### Steps #### Update Collection Version Modify the [galaxy.yaml](./galaxy.yml) file to the desired collection version: ```yaml version: {NEW_VERSION} ``` Ansible collection versions [must follow SEMVER](https://docs.ansible.com/ansible/devel/dev_guide/developing_collections_distributing.html#collection-versions). Alpha / beta releases are optional. #### Update the changelog Providing a valid [CHANGELOG.rst](./CHANGELOG.rst) is required for a certifiable collection release. Use the [antsibull-changelog](https://github.com/ansible-community/antsibull-changelog) tool to generate the changelog: ```sh pip install antsibull-changelog antsibull-changelog release ``` This will remove all the changelog fragments from ./changelogs/fragments and merge them into CHANGELOG.rst. ### Create a new GitHub release Creating - [publish to Ansible Galaxy](./.github/workflows/pythonpublish.yml). ### Publish to Automation Hub *note*: As automation Hub only accepts production releases, this step is only required for new full releases. This step does not use GitHub actions, as API keys for Automation Hub expire after 30 days of no use, and a maintainer may find themselves refreshing tokens every time anyway. Steps: 1. Build the package locally: `ansible-galaxy collection build .` 1. [Go to the Automation Hub my-namespaces page, then click on Google](https://console.redhat.com/ansible/automation-hub/repo/published/my-namespaces/google/) 1. Publish the package