Issue #40: Add changelog and fragments and document new changelog process.

changelogs/.plugin-cache.yaml

@@ -0,0 +1,83 @@
+plugins:
+  become: {}
+  cache: {}
+  callback: {}
+  cliconf: {}
+  connection:
+    kubectl:
+      description: Execute tasks in pods running on Kubernetes.
+      name: kubectl
+      version_added: null
+  httpapi: {}
+  inventory:
+    k8s:
+      description: Kubernetes (K8s) inventory source
+      name: k8s
+      version_added: null
+    openshift:
+      description: OpenShift inventory source
+      name: openshift
+      version_added: null
+  lookup:
+    k8s:
+      description: Query the K8s API
+      name: k8s
+      version_added: null
+  module:
+    helm:
+      description: Manages Kubernetes packages with the Helm package manager
+      name: helm
+      namespace: .ansible.collections.ansible_collections.community.kubernetes.plugins.modules
+      version_added: 0.11.0
+    helm_info:
+      description: Get information from Helm package deployed inside the cluster
+      name: helm_info
+      namespace: .ansible.collections.ansible_collections.community.kubernetes.plugins.modules
+      version_added: 0.11.0
+    helm_repository:
+      description: Add and remove Helm repository
+      name: helm_repository
+      namespace: .ansible.collections.ansible_collections.community.kubernetes.plugins.modules
+      version_added: 0.11.0
+    k8s:
+      description: Manage Kubernetes (K8s) objects
+      name: k8s
+      namespace: .ansible.collections.ansible_collections.community.kubernetes.plugins.modules
+      version_added: null
+    k8s_auth:
+      description: Authenticate to Kubernetes clusters which require an explicit login
+        step
+      name: k8s_auth
+      namespace: .ansible.collections.ansible_collections.community.kubernetes.plugins.modules
+      version_added: null
+    k8s_exec:
+      description: Execute command in Pod
+      name: k8s_exec
+      namespace: .ansible.collections.ansible_collections.community.kubernetes.plugins.modules
+      version_added: 0.10.0
+    k8s_info:
+      description: Describe Kubernetes (K8s) objects
+      name: k8s_info
+      namespace: .ansible.collections.ansible_collections.community.kubernetes.plugins.modules
+      version_added: null
+    k8s_log:
+      description: Fetch logs from Kubernetes resources
+      name: k8s_log
+      namespace: .ansible.collections.ansible_collections.community.kubernetes.plugins.modules
+      version_added: 0.10.0
+    k8s_scale:
+      description: Set a new size for a Deployment, ReplicaSet, Replication Controller,
+        or Job.
+      name: k8s_scale
+      namespace: .ansible.collections.ansible_collections.community.kubernetes.plugins.modules
+      version_added: null
+    k8s_service:
+      description: Manage Services on Kubernetes
+      name: k8s_service
+      namespace: .ansible.collections.ansible_collections.community.kubernetes.plugins.modules
+      version_added: null
+  netconf: {}
+  shell: {}
+  strategy: {}
+  vars: {}
+version: 0.11.0

changelogs/CHANGELOG.rst

@@ -0,0 +1,86 @@
+===================================
+Kubernetes Collection Release Notes
+===================================
+
+.. contents:: Topics
+
+
+v0.11.0
+=======
+
+Major Changes
+-------------
+
+- helm - New module for managing Helm charts.
+- helm_info - New module for retrieving Helm chart information.
+- helm_repository - New module for managing Helm repositories.
+
+Minor Changes
+-------------
+
+- Rename repository to ``community.kubernetes``.
+
+Bugfixes
+--------
+
+- Make sure extra files are not included in built collection.
+- Update GitHub Actions workflow for better CI stability.
+- k8s_log - Module no longer attempts to parse log as JSON.
+
+New Modules
+-----------
+
+- helm - Manages Kubernetes packages with the Helm package manager
+- helm_info - Get information from Helm package deployed inside the cluster
+- helm_repository - Add and remove Helm repository
+
+v0.10.0
+=======
+
+Major Changes
+-------------
+
+- k8s_exec - New module for executing commands on pods via Kubernetes API.
+- k8s_log - New module for retrieving pod logs.
+
+Minor Changes
+-------------
+
+- k8s - Added ``persist_config`` option for persisting refreshed tokens.
+
+Security Fixes
+--------------
+
+- kubectl - Warn about information disclosure when using options like ``kubectl_password``, ``kubectl_extra_args``, and ``kubectl_token`` to pass data through to the command line using the ``kubectl`` connection plugin.
+
+Bugfixes
+--------
+
+- k8s - Add exception handling when retrieving k8s client.
+- k8s - Fix argspec for 'elements'.
+- k8s - Use ``from_yaml`` filter with lookup examples in ``k8s`` module documentation examples.
+- k8s_service - Fix argspec.
+- kubectl - Fix documentation in kubectl connection plugin.
+
+New Modules
+-----------
+
+- k8s_exec - Execute command in Pod
+- k8s_log - Fetch logs from Kubernetes resources
+
+v0.9.0
+======
+
+Major Changes
+-------------
+
+- k8s - Inventory source migrated from Ansible 2.9 to Kubernetes collection.
+- k8s - Lookup plugin migrated from Ansible 2.9 to Kubernetes collection.
+- k8s - Module migrated from Ansible 2.9 to Kubernetes collection.
+- k8s_auth - Module migrated from Ansible 2.9 to Kubernetes collection.
+- k8s_config_resource_name - Filter plugin migrated from Ansible 2.9 to Kubernetes collection.
+- k8s_info - Module migrated from Ansible 2.9 to Kubernetes collection.
+- k8s_scale - Module migrated from Ansible 2.9 to Kubernetes collection.
+- k8s_service - Module migrated from Ansible 2.9 to Kubernetes collection.
+- kubectl - Connection plugin migrated from Ansible 2.9 to Kubernetes collection.
+- openshift - Inventory source migrated from Ansible 2.9 to Kubernetes collection.

changelogs/changelog.yaml

@@ -0,0 +1,84 @@
+ancestor: null
+releases:
+  0.10.0:
+    changes:
+      bugfixes:
+      - k8s - Add exception handling when retrieving k8s client.
+      - k8s - Fix argspec for 'elements'.
+      - k8s - Use ``from_yaml`` filter with lookup examples in ``k8s`` module documentation
+        examples.
+      - k8s_service - Fix argspec.
+      - kubectl - Fix documentation in kubectl connection plugin.
+      major_changes:
+      - k8s_exec - New module for executing commands on pods via Kubernetes API.
+      - k8s_log - New module for retrieving pod logs.
+      minor_changes:
+      - k8s - Added ``persist_config`` option for persisting refreshed tokens.
+      security_fixes:
+      - kubectl - Warn about information disclosure when using options like ``kubectl_password``,
+        ``kubectl_extra_args``, and ``kubectl_token`` to pass data through to the
+        command line using the ``kubectl`` connection plugin.
+    fragments:
+    - 13-fix-elements-argspec.yaml
+    - 14-k8s_exec-new-module.yaml
+    - 16-k8s_log-new-module.yaml
+    - 33-k8s_service-fix-argspec.yaml
+    - 49-k8s-add-persist_config-option.yaml
+    - 51-kubectl-security-disclosure.yaml
+    - 52-kubectl-connection-docsfix.yaml
+    - 54-k8s-add-exception-handling.yaml
+    - 56-k8s-from_yaml-docs-examples.yaml
+    modules:
+    - description: Execute command in Pod
+      name: k8s_exec
+      namespace: .ansible.collections.ansible_collections.community.kubernetes.plugins.modules
+    - description: Fetch logs from Kubernetes resources
+      name: k8s_log
+      namespace: .ansible.collections.ansible_collections.community.kubernetes.plugins.modules
+    release_date: '2020-03-23'
+  0.11.0:
+    changes:
+      bugfixes:
+      - Make sure extra files are not included in built collection.
+      - Update GitHub Actions workflow for better CI stability.
+      - k8s_log - Module no longer attempts to parse log as JSON.
+      major_changes:
+      - helm - New module for managing Helm charts.
+      - helm_info - New module for retrieving Helm chart information.
+      - helm_repository - New module for managing Helm repositories.
+      minor_changes:
+      - Rename repository to ``community.kubernetes``.
+    fragments:
+    - 61-helm-new-modules.yaml
+    - 69-k8s_log-dont-parse-as-json.yaml
+    - 78-github-actions-workflow.yaml
+    - 81-rename-repository.yaml
+    - 85-exclude-unnecessary-files-when-building.yaml
+    modules:
+    - description: Manages Kubernetes packages with the Helm package manager
+      name: helm
+      namespace: .ansible.collections.ansible_collections.community.kubernetes.plugins.modules
+    - description: Get information from Helm package deployed inside the cluster
+      name: helm_info
+      namespace: .ansible.collections.ansible_collections.community.kubernetes.plugins.modules
+    - description: Add and remove Helm repository
+      name: helm_repository
+      namespace: .ansible.collections.ansible_collections.community.kubernetes.plugins.modules
+    release_date: '2020-05-04'
+  0.9.0:
+    changes:
+      major_changes:
+      - k8s - Inventory source migrated from Ansible 2.9 to Kubernetes collection.
+      - k8s - Lookup plugin migrated from Ansible 2.9 to Kubernetes collection.
+      - k8s - Module migrated from Ansible 2.9 to Kubernetes collection.
+      - k8s_auth - Module migrated from Ansible 2.9 to Kubernetes collection.
+      - k8s_config_resource_name - Filter plugin migrated from Ansible 2.9 to Kubernetes
+        collection.
+      - k8s_info - Module migrated from Ansible 2.9 to Kubernetes collection.
+      - k8s_scale - Module migrated from Ansible 2.9 to Kubernetes collection.
+      - k8s_service - Module migrated from Ansible 2.9 to Kubernetes collection.
+      - kubectl - Connection plugin migrated from Ansible 2.9 to Kubernetes collection.
+      - openshift - Inventory source migrated from Ansible 2.9 to Kubernetes collection.
+    fragments:
+    - 4-k8s-prepare-collection-for-release.yaml
+    release_date: '2020-02-05'

changelogs/config.yaml

@@ -0,0 +1,29 @@
+changelog_filename_template: CHANGELOG.rst
+changelog_filename_version_depth: 0
+changes_file: changelog.yaml
+changes_format: combined
+keep_fragments: true
+mention_ancestor: true
+new_plugins_after_name: removed_features
+notesdir: fragments
+prelude_section_name: release_summary
+prelude_section_title: Release Summary
+sections:
+- - major_changes
+  - Major Changes
+- - minor_changes
+  - Minor Changes
+- - breaking_changes
+  - Breaking Changes / Porting Guide
+- - deprecated_features
+  - Deprecated Features
+- - removed_features
+  - Removed Features (previously deprecated)
+- - security_fixes
+  - Security Fixes
+- - bugfixes
+  - Bugfixes
+- - known_issues
+  - Known Issues
+title: Kubernetes Collection
+trivial_section_name: trivial

changelogs/fragments/13-fix-elements-argspec.yaml

@@ -0,0 +1,3 @@
+---
+bugfixes:
+  - k8s - Fix argspec for 'elements'.

changelogs/fragments/14-k8s_exec-new-module.yaml

@@ -0,0 +1,3 @@
+---
+major_changes:
+  - k8s_exec - New module for executing commands on pods via Kubernetes API.

changelogs/fragments/16-k8s_log-new-module.yaml

@@ -0,0 +1,3 @@
+---
+major_changes:
+  - k8s_log - New module for retrieving pod logs.

changelogs/fragments/33-k8s_service-fix-argspec.yaml

@@ -0,0 +1,3 @@
+---
+bugfixes:
+  - k8s_service - Fix argspec.

changelogs/fragments/4-k8s-prepare-collection-for-release.yaml

@@ -0,0 +1,12 @@
+---
+major_changes:
+  - k8s - Inventory source migrated from Ansible 2.9 to Kubernetes collection.
+  - k8s - Module migrated from Ansible 2.9 to Kubernetes collection.
+  - k8s - Lookup plugin migrated from Ansible 2.9 to Kubernetes collection.
+  - k8s_auth - Module migrated from Ansible 2.9 to Kubernetes collection.
+  - k8s_info - Module migrated from Ansible 2.9 to Kubernetes collection.
+  - k8s_scale - Module migrated from Ansible 2.9 to Kubernetes collection.
+  - k8s_service - Module migrated from Ansible 2.9 to Kubernetes collection.
+  - k8s_config_resource_name - Filter plugin migrated from Ansible 2.9 to Kubernetes collection.
+  - kubectl - Connection plugin migrated from Ansible 2.9 to Kubernetes collection.
+  - openshift - Inventory source migrated from Ansible 2.9 to Kubernetes collection.

changelogs/fragments/49-k8s-add-persist_config-option.yaml

@@ -0,0 +1,3 @@
+---
+minor_changes:
+  - k8s - Added ``persist_config`` option for persisting refreshed tokens.

changelogs/fragments/51-kubectl-security-disclosure.yaml

@@ -0,0 +1,3 @@
+---
+security_fixes:
+  - kubectl - Warn about information disclosure when using options like ``kubectl_password``, ``kubectl_extra_args``, and ``kubectl_token`` to pass data through to the command line using the ``kubectl`` connection plugin.

changelogs/fragments/52-kubectl-connection-docsfix.yaml

@@ -0,0 +1,3 @@
+---
+bugfixes:
+  - kubectl - Fix documentation in kubectl connection plugin.

changelogs/fragments/54-k8s-add-exception-handling.yaml

@@ -0,0 +1,3 @@
+---
+bugfixes:
+  - k8s - Add exception handling when retrieving k8s client.

changelogs/fragments/56-k8s-from_yaml-docs-examples.yaml

@@ -0,0 +1,3 @@
+---
+bugfixes:
+  - k8s - Use ``from_yaml`` filter with lookup examples in ``k8s`` module documentation examples.

changelogs/fragments/61-helm-new-modules.yaml

@@ -0,0 +1,5 @@
+---
+major_changes:
+  - helm - New module for managing Helm charts.
+  - helm_info - New module for retrieving Helm chart information.
+  - helm_repository - New module for managing Helm repositories.

changelogs/fragments/69-k8s_log-dont-parse-as-json.yaml

@@ -0,0 +1,3 @@
+---
+bugfixes:
+  - k8s_log - Module no longer attempts to parse log as JSON.

changelogs/fragments/78-github-actions-workflow.yaml

@@ -0,0 +1,3 @@
+---
+bugfixes:
+  - Update GitHub Actions workflow for better CI stability.

changelogs/fragments/81-rename-repository.yaml

@@ -0,0 +1,3 @@
+---
+minor_changes:
+  - Rename repository to ``community.kubernetes``.

changelogs/fragments/85-exclude-unnecessary-files-when-building.yaml

@@ -0,0 +1,3 @@
+---
+bugfixes:
+  - Make sure extra files are not included in built collection.