diff options
Diffstat (limited to 'ansible_collections/amazon/aws/.github')
10 files changed, 699 insertions, 0 deletions
diff --git a/ansible_collections/amazon/aws/.github/BOTMETA.yml b/ansible_collections/amazon/aws/.github/BOTMETA.yml new file mode 100644 index 00000000..1efbcc4c --- /dev/null +++ b/ansible_collections/amazon/aws/.github/BOTMETA.yml @@ -0,0 +1,110 @@ +automerge: false +files: + maintainers: $team_aws + docs/: + labels: docs + $action/: + labels: action + $action/aws_s3.py: + $callback/: + labels: callback + $doc_fragments/: + labels: doc_fragments + $doc_fragments/aws.py: + $doc_fragments/aws_credentials.py: + $doc_fragments/aws_region.py: + $doc_fragments/ec2.py: + $inventory/: + labels: inventory + $inventory/aws_ec2.py: + labels: inventory + $inventory/aws_rds.py: + labels: inventory + $lookup/: + labels: lookup + $module_utils/: + labels: module_utils + $module_utils/ec2.py: + labels: ec2 + $modules/: + authors: wimnat + maintainers: $team_aws + ignore: erydo nadirollo seiffert tedder wimnat + labels: modules + $modules/_aws_az_facts.py: + authors: Sodki + $modules/_aws_caller_facts.py: + authors: orthanc sdubrul + $modules/_cloudformation_facts.py: + authors: jmenga waffie1 + $modules/_ec2_ami_facts.py: + authors: prasadkatti + $modules/_ec2_group_facts.py: + authors: Sodki + $modules/_ec2_vpc_dhcp_option_facts.py: + authors: naslanidis + $modules/aws_az_info.py: + authors: Sodki + $modules/aws_caller_info.py: + authors: orthanc sdubrul + $modules/aws_s3.py: + authors: lwade s-hertel + $modules/cloudformation.py: + authors: jsmartin + $modules/cloudformation_info.py: + authors: jmenga waffie1 + $modules/ec2.py: + authors: lwade skvidal tgerla + labels: ec2 + ignore: erydo nadirollo seiffert skvidal + $modules/ec2_ami.py: + authors: Constantin07 gunzy83 scicoin-project wilvk + $modules/ec2_ami_info.py: + authors: prasadkatti + $modules/ec2_elb_lb.py: + authors: jsdalton + $modules/ec2_group.py: + authors: adq + $modules/ec2_group_info.py: + authors: Sodki + $modules/ec2_key.py: + authors: prasadkatti zbal + $modules/ec2_metadata_facts.py: + authors: roadmapper silviud + $modules/ec2_snapshot.py: + authors: willthames + $modules/ec2_tag.py: + authors: flowerysong lwade + $modules/ec2_tag_info.py: + authors: tremble + maintainers: jillr s-hertel + $modules/ec2_vol.py: + authors: lwade + $modules/ec2_vpc_dhcp_option.py: + authors: joelthompson + $modules/ec2_vpc_dhcp_option_info.py: + authors: naslanidis + $modules/ec2_vpc_net.py: + authors: defionscode s-hertel + ignore: defionscode joshsouza ryansb simplesteph + $modules/ec2_vpc_net_info.py: + maintainers: whiter + $modules/ec2_vpc_subnet.py: + authors: brandond erydo + scripts/inventory/: + labels: inventory + tests/: + labels: tests + tests/integration/: + labels: integrations + tests/units/: + labels: units +macros: + action: plugins/action + callback: plugins/callback + doc_fragments: plugins/doc_fragments + inventory: plugins/inventory + lookup: plugins/lookup + module_utils: plugins/module_utils + modules: plugins/modules + team_aws: jillr s-hertel tremble diff --git a/ansible_collections/amazon/aws/.github/ISSUE_TEMPLATE/bug_report.yml b/ansible_collections/amazon/aws/.github/ISSUE_TEMPLATE/bug_report.yml new file mode 100644 index 00000000..c818de3e --- /dev/null +++ b/ansible_collections/amazon/aws/.github/ISSUE_TEMPLATE/bug_report.yml @@ -0,0 +1,161 @@ +--- +name: Bug report +description: Create a report to help us improve + +body: +- type: markdown + attributes: + value: | + ⚠ + Verify first that your issue is not [already reported on GitHub][issue search]. + Where possible also test if the latest release and main branch are affected too. + *Complete **all** sections as described, this form is processed automatically.* + + [issue search]: https://github.com/ansible-collections/amazon.aws/search?q=is%3Aissue&type=issues + +- type: textarea + attributes: + label: Summary + description: | + Explain the problem briefly below. + placeholder: >- + When I try to do X with the collection from the main branch on GitHub, Y + breaks in a way Z under the env E. Here are all the details I know + about this problem... + validations: + required: true + +- type: dropdown + attributes: + label: Issue Type + # FIXME: Once GitHub allows defining the default choice, update this + options: + - Bug Report + validations: + required: true + +- type: textarea + attributes: + # For smaller collections we could use a multi-select and hardcode the list + # May generate this list via GitHub action and walking files under https://github.com/ansible-collections/community.general/tree/main/plugins + # Select from list, filter as you type (`mysql` would only show the 3 mysql components) + # OR freeform - doesn't seem to be supported in adaptivecards + label: Component Name + description: >- + Write the short name of the module or plugin below, + *use your best guess if unsure*. + placeholder: ec2_instance, ec2_security_group + validations: + required: true + +- type: textarea + attributes: + label: Ansible Version + description: >- + Paste verbatim output from `ansible --version` between + tripple backticks. + value: | + ```console (paste below) + $ ansible --version + + ``` + validations: + required: true + +- type: textarea + attributes: + label: Collection Versions + description: >- + Paste verbatim output from `ansible-galaxy collection list` between + tripple backticks. + value: | + ```console (paste below) + $ ansible-galaxy collection list + ``` + validations: + required: true + +- type: textarea + attributes: + label: AWS SDK versions + description: >- + The AWS modules depend heavily on the Amazon AWS SDKs which are regularly updated. + Paste verbatim output from `pip show boto boto3 botocore` between quotes + value: | + ```console (paste below) + $ pip show boto boto3 botocore + ``` + validations: + required: true + +- type: textarea + attributes: + label: Configuration + description: >- + If this issue has an example piece of YAML that can help to reproduce this problem, please provide it. + This can be a piece of YAML from, e.g., an automation, script, scene or configuration. + + Paste verbatim output from `ansible-config dump --only-changed` between quotes + value: | + ```console (paste below) + $ ansible-config dump --only-changed + + ``` + +- type: textarea + attributes: + label: OS / Environment + description: >- + Provide all relevant information below, e.g. target OS versions, + network device firmware, etc. + placeholder: RHEL 8, CentOS Stream etc. + validations: + required: false + +- type: textarea + attributes: + label: Steps to Reproduce + description: | + Describe exactly how to reproduce the problem, using a minimal test-case. It would *really* help us understand your problem if you could also paste any playbooks, configs and commands you used. + + **HINT:** You can paste https://gist.github.com links for larger files. + value: | + <!--- Paste example playbooks or commands between quotes below --> + ```yaml (paste below) + + ``` + validations: + required: true + +- type: textarea + attributes: + label: Expected Results + description: >- + Describe what you expected to happen when running the steps above. + placeholder: >- + I expected X to happen because I assumed Y. + that it did not. + validations: + required: true + +- type: textarea + attributes: + label: Actual Results + description: | + Describe what actually happened. If possible run with extra verbosity (`-vvvv`). + + Paste verbatim command output between quotes. + value: | + ```console (paste below) + + ``` + +- type: checkboxes + attributes: + label: Code of Conduct + description: | + Read the [Ansible Code of Conduct](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html?utm_medium=github&utm_source=issue_form--ansible-collections) first. + options: + - label: I agree to follow the Ansible Code of Conduct + required: true +... diff --git a/ansible_collections/amazon/aws/.github/ISSUE_TEMPLATE/ci_report.yml b/ansible_collections/amazon/aws/.github/ISSUE_TEMPLATE/ci_report.yml new file mode 100644 index 00000000..aceb2ec8 --- /dev/null +++ b/ansible_collections/amazon/aws/.github/ISSUE_TEMPLATE/ci_report.yml @@ -0,0 +1,76 @@ +--- +name: CI Bug Report +description: Create a report to help us improve our CI + +body: +- type: markdown + attributes: + value: | + ⚠ + Verify first that your issue is not [already reported on GitHub][issue search]. + *Complete **all** sections as described, this form is processed automatically.* + + [issue search]: https://github.com/ansible-collections/amazon.aws/search?q=is%3Aissue&type=issues + +- type: textarea + attributes: + label: Summary + description: | + Describe the new issue briefly below. + placeholder: >- + I opened a Pull Request and CI failed to run. I believe this is due to a problem with the CI rather than my code. + validations: + required: true + +- type: dropdown + attributes: + label: Issue Type + # FIXME: Once GitHub allows defining the default choice, update this + options: + - CI Bug Report + validations: + required: true + +- type: textarea + attributes: + label: CI Jobs + description: >- + Please provide a link to the failed CI tests. + placeholder: https://dashboard.zuul.ansible.com/t/ansible/buildset/be956faa49d84e43bc860d0cd3dc8503 + validations: + required: false + +- type: textarea + attributes: + label: Pull Request + description: >- + Please provide a link to the Pull Request where the tests are failing + placeholder: https://github.com/ansible-collections/amazon.aws/runs/3040421733 + validations: + required: false + +- type: textarea + attributes: + label: Additional Information + description: | + Please provide as much information as possible to help us understand the issue being reported. + Where possible, please include the specific errors that you're seeing. + + **HINT:** You can paste https://gist.github.com links for larger files. + value: | + <!--- Paste example playbooks or commands between quotes below --> + ```yaml (paste below) + + ``` + validations: + required: false + +- type: checkboxes + attributes: + label: Code of Conduct + description: | + Read the [Ansible Code of Conduct](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html?utm_medium=github&utm_source=issue_form--ansible-collections) first. + options: + - label: I agree to follow the Ansible Code of Conduct + required: true +... diff --git a/ansible_collections/amazon/aws/.github/ISSUE_TEMPLATE/config.yml b/ansible_collections/amazon/aws/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 00000000..f90bd1ad --- /dev/null +++ b/ansible_collections/amazon/aws/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,27 @@ +--- +# Ref: https://help.github.com/en/github/building-a-strong-community/configuring-issue-templates-for-your-repository#configuring-the-template-chooser +blank_issues_enabled: false # default: true +contact_links: +- name: Security bug report + url: https://docs.ansible.com/ansible-core/devel/community/reporting_bugs_and_features.html?utm_medium=github&utm_source=issue_template_chooser_ansible_collections + about: | + Please learn how to report security vulnerabilities here. + + For all security related bugs, email security@ansible.com + instead of using this issue tracker and you will receive + a prompt response. + + For more information, see + https://docs.ansible.com/ansible/latest/community/reporting_bugs_and_features.html +- name: Ansible Code of Conduct + url: https://docs.ansible.com/ansible/latest/community/code_of_conduct.html?utm_medium=github&utm_source=issue_template_chooser_ansible_collections + about: Be nice to other members of the community. +- name: Talks to the community + url: https://docs.ansible.com/ansible/latest/community/communication.html?utm_medium=github&utm_source=issue_template_chooser#mailing-list-information + about: Please ask and answer usage questions here +- name: Working groups + url: https://github.com/ansible/community/wiki + about: Interested in improving a specific area? Become a part of a working group! +- name: For Enterprise + url: https://www.ansible.com/products/engine?utm_medium=github&utm_source=issue_template_chooser_ansible_collections + about: Red Hat offers support for the Ansible Automation Platform diff --git a/ansible_collections/amazon/aws/.github/ISSUE_TEMPLATE/documentation_report.yml b/ansible_collections/amazon/aws/.github/ISSUE_TEMPLATE/documentation_report.yml new file mode 100644 index 00000000..b88a8161 --- /dev/null +++ b/ansible_collections/amazon/aws/.github/ISSUE_TEMPLATE/documentation_report.yml @@ -0,0 +1,130 @@ +--- +name: Documentation Report +description: Ask us about docs +# NOTE: issue body is enabled to allow screenshots + +body: +- type: markdown + attributes: + value: | + ⚠ + Verify first that your issue is not [already reported on GitHub][issue search]. + Where possible also test if the latest release and main branch are affected too. + *Complete **all** sections as described, this form is processed automatically.* + + [issue search]: https://github.com/ansible-collections/amazon.aws/search?q=is%3Aissue&type=issues + +- type: textarea + attributes: + label: Summary + description: | + Explain the problem briefly below, add suggestions to wording or structure. + + **HINT:** Did you know the documentation has an `Edit on GitHub` link on every page? + placeholder: >- + I was reading the Collection documentation of version X and I'm having + problems understanding Y. It would be very helpful if that got + rephrased as Z. + validations: + required: true + +- type: dropdown + attributes: + label: Issue Type + # FIXME: Once GitHub allows defining the default choice, update this + options: + - Documentation Report + validations: + required: true + +- type: textarea + attributes: + # For smaller collections we could use a multi-select and hardcode the list + # May generate this list via GitHub action and walking files under https://github.com/ansible-collections/community.general/tree/main/plugins + # Select from list, filter as you type (`mysql` would only show the 3 mysql components) + # OR freeform - doesn't seem to be supported in adaptivecards + label: Component Name + description: >- + Write the short name of the rst file, module, plugin or task below, + *use your best guess if unsure*. + placeholder: ec2_instance, ec2_security_group + validations: + required: true + +- type: textarea + attributes: + label: Ansible Version + description: >- + Paste verbatim output from `ansible --version` between + tripple backticks. + value: | + ```console (paste below) + $ ansible --version + + ``` + validations: + required: false + +- type: textarea + attributes: + label: Collection Versions + description: >- + Paste verbatim output from `ansible-galaxy collection list` between + tripple backticks. + value: | + ```console (paste below) + $ ansible-galaxy collection list + ``` + validations: + required: false + +- type: textarea + attributes: + label: Configuration + description: >- + If this issue has an example piece of YAML that can help to reproduce this problem, please provide it. + This can be a piece of YAML from, e.g., an automation, script, scene or configuration. + + Paste verbatim output from `ansible-config dump --only-changed` between quotes + value: | + ```console (paste below) + $ ansible-config dump --only-changed + + ``` + validations: + required: false + +- type: textarea + attributes: + label: OS / Environment + description: >- + Provide all relevant information below, e.g. OS version, + browser, etc. + placeholder: RHEL 8, Firefox etc. + validations: + required: false + +- type: textarea + attributes: + label: Additional Information + description: | + Describe how this improves the documentation, e.g. before/after situation or screenshots. + + **Tip:** It's not possible to upload the screenshot via this field directly but you can use the last textarea in this form to attach them. + + **HINT:** You can paste https://gist.github.com links for larger files. + placeholder: >- + When the improvement is applied, it makes it more straightforward + to understand X. + validations: + required: false + +- type: checkboxes + attributes: + label: Code of Conduct + description: | + Read the [Ansible Code of Conduct](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html?utm_medium=github&utm_source=issue_form--ansible-collections) first. + options: + - label: I agree to follow the Ansible Code of Conduct + required: true +... diff --git a/ansible_collections/amazon/aws/.github/ISSUE_TEMPLATE/feature_request.yml b/ansible_collections/amazon/aws/.github/ISSUE_TEMPLATE/feature_request.yml new file mode 100644 index 00000000..4178d067 --- /dev/null +++ b/ansible_collections/amazon/aws/.github/ISSUE_TEMPLATE/feature_request.yml @@ -0,0 +1,74 @@ +--- +name: Feature request +description: Suggest an idea for this project + +body: +- type: markdown + attributes: + value: | + ⚠ + Verify first that your issue is not [already reported on GitHub][issue search]. + Where possible also test if the latest release and main branch are affected too. + *Complete **all** sections as described, this form is processed automatically.* + + [issue search]: https://github.com/ansible-collections/amazon.aws/search?q=is%3Aissue&type=issues + +- type: textarea + attributes: + label: Summary + description: | + Describe the new feature/improvement briefly below. + placeholder: >- + I am trying to do X with the collection from the main branch on GitHub and + I think that implementing a feature Y would be very helpful for me and + every other user of amazon.aws because of Z. + validations: + required: true + +- type: dropdown + attributes: + label: Issue Type + # FIXME: Once GitHub allows defining the default choice, update this + options: + - Feature Idea + validations: + required: true + +- type: textarea + attributes: + # For smaller collections we could use a multi-select and hardcode the list + # May generate this list via GitHub action and walking files under https://github.com/ansible-collections/community.general/tree/main/plugins + # Select from list, filter as you type (`mysql` would only show the 3 mysql components) + # OR freeform - doesn't seem to be supported in adaptivecards + label: Component Name + description: >- + Write the short name of the module or plugin below, + *use your best guess if unsure*. + placeholder: ec2_instance, ec2_security_group + validations: + required: true + +- type: textarea + attributes: + label: Additional Information + description: | + Describe how the feature would be used, why it is needed and what it would solve. + + **HINT:** You can paste https://gist.github.com links for larger files. + value: | + <!--- Paste example playbooks or commands between quotes below --> + ```yaml (paste below) + + ``` + validations: + required: false + +- type: checkboxes + attributes: + label: Code of Conduct + description: | + Read the [Ansible Code of Conduct](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html?utm_medium=github&utm_source=issue_form--ansible-collections) first. + options: + - label: I agree to follow the Ansible Code of Conduct + required: true +... diff --git a/ansible_collections/amazon/aws/.github/patchback.yml b/ansible_collections/amazon/aws/.github/patchback.yml new file mode 100644 index 00000000..113fc529 --- /dev/null +++ b/ansible_collections/amazon/aws/.github/patchback.yml @@ -0,0 +1,4 @@ +--- +backport_branch_prefix: patchback/backports/ +backport_label_prefix: backport- +target_branch_prefix: stable- diff --git a/ansible_collections/amazon/aws/.github/settings.yml b/ansible_collections/amazon/aws/.github/settings.yml new file mode 100644 index 00000000..b27b575f --- /dev/null +++ b/ansible_collections/amazon/aws/.github/settings.yml @@ -0,0 +1,5 @@ +# DO NOT MODIFY + +# Settings: https://probot.github.io/apps/settings/ +# Pull settings from https://github.com/ansible-collections/.github/blob/master/.github/settings.yml +_extends: ".github" diff --git a/ansible_collections/amazon/aws/.github/workflows/docs-pr.yml b/ansible_collections/amazon/aws/.github/workflows/docs-pr.yml new file mode 100644 index 00000000..10cb50de --- /dev/null +++ b/ansible_collections/amazon/aws/.github/workflows/docs-pr.yml @@ -0,0 +1,73 @@ +name: Collection Docs +concurrency: + group: docs-${{ github.head_ref }} + cancel-in-progress: true +on: + pull_request_target: + types: [opened, synchronize, reopened, closed] + +env: + GHP_BASE_URL: https://${{ github.repository_owner }}.github.io/${{ github.event.repository.name }} + +jobs: + validate-docs: + permissions: + contents: read + name: Validate Ansible Docs + uses: ansible-community/github-docs-build/.github/workflows/_shared-docs-build-pr.yml@main + with: + init-lenient: false + init-fail-on-error: true + intersphinx-links: | + community_aws:https://ansible-collections.github.io/community.aws/branch/main/ + ansible_devel:https://docs.ansible.com/ansible-core/devel/ + + + build-docs: + permissions: + contents: read + name: Build Ansible Docs + uses: ansible-community/github-docs-build/.github/workflows/_shared-docs-build-pr.yml@main + with: + init-lenient: true + init-fail-on-error: false + intersphinx-links: | + community_aws:https://ansible-collections.github.io/community.aws/branch/main/ + ansible_devel:https://docs.ansible.com/ansible-core/devel/ + + comment: + permissions: + pull-requests: write + runs-on: ubuntu-latest + needs: [build-docs] + name: PR comments + steps: + - name: PR comment + uses: ansible-community/github-docs-build/actions/ansible-docs-build-comment@main + with: + body-includes: '## Docs Build' + reactions: heart + action: ${{ needs.build-docs.outputs.changed != 'true' && 'remove' || '' }} + on-closed-action: remove + on-merged-body: | + ## Docs Build 📝 + + Thank you for contribution!✨ + + This PR has been merged and your docs changes will be incorporated when they are next published. + body: | + ## Docs Build 📝 + + Thank you for contribution!✨ + + The docsite for **this PR** is available for download as an artifact from this run: + ${{ needs.build-docs.outputs.artifact-url }} + + You can compare to the docs for the `main` branch here: + ${{ env.GHP_BASE_URL }}/branch/main + + File changes: + + ${{ needs.build-docs.outputs.diff-files-rendered }} + + ${{ needs.build-docs.outputs.diff-rendered }} diff --git a/ansible_collections/amazon/aws/.github/workflows/docs-push.yml b/ansible_collections/amazon/aws/.github/workflows/docs-push.yml new file mode 100644 index 00000000..0acd9320 --- /dev/null +++ b/ansible_collections/amazon/aws/.github/workflows/docs-push.yml @@ -0,0 +1,39 @@ +name: Collection Docs +concurrency: + group: docs-push-${{ github.sha }} + cancel-in-progress: true +on: + push: + branches: + - main + - stable-* + tags: + - '*' + schedule: + - cron: '0 12 * * *' + +jobs: + build-docs: + permissions: + contents: read + name: Build Ansible Docs + uses: ansible-community/github-docs-build/.github/workflows/_shared-docs-build-push.yml@main + with: + init-lenient: false + init-fail-on-error: true + intersphinx-links: | + community_aws:https://ansible-collections.github.io/community.aws/branch/main/ + ansible_devel:https://docs.ansible.com/ansible-core/devel/ + + publish-docs-gh-pages: + # use to prevent running on forks + if: github.repository == 'ansible-collections/amazon.aws' + permissions: + contents: write + needs: [build-docs] + name: Publish Ansible Docs + uses: ansible-community/github-docs-build/.github/workflows/_shared-docs-build-publish-gh-pages.yml@main + with: + artifact-name: ${{ needs.build-docs.outputs.artifact-name }} + secrets: + GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} |