Update Kubernetes collection name in docs (#74440)
This commit is contained in:
parent
63afb33d86
commit
8d499bbc83
8 changed files with 20 additions and 20 deletions
|
@ -24,12 +24,12 @@ To include documentation fragments in your collection:
|
||||||
.. code-block:: yaml
|
.. code-block:: yaml
|
||||||
|
|
||||||
extends_documentation_fragment:
|
extends_documentation_fragment:
|
||||||
- community.kubernetes.k8s_name_options
|
- kubernetes.core.k8s_name_options
|
||||||
- community.kubernetes.k8s_auth_options
|
- kubernetes.core.k8s_auth_options
|
||||||
- community.kubernetes.k8s_resource_options
|
- kubernetes.core.k8s_resource_options
|
||||||
- community.kubernetes.k8s_scale_options
|
- kubernetes.core.k8s_scale_options
|
||||||
|
|
||||||
:ref:`module_docs_fragments` covers the basics for documentation fragments. The `kubernetes <https://github.com/ansible-collections/kubernetes>`_ collection includes a complete example.
|
:ref:`module_docs_fragments` covers the basics for documentation fragments. The `kubernetes.core <https://github.com/ansible-collections/kubernetes.core>`_ collection includes a complete example.
|
||||||
|
|
||||||
If you use FQCN, you can use documentation fragments from one collection in another collection.
|
If you use FQCN, you can use documentation fragments from one collection in another collection.
|
||||||
|
|
||||||
|
|
|
@ -255,7 +255,7 @@ content in a uniform way:
|
||||||
.. note::
|
.. note::
|
||||||
- To refer to a group of modules in a collection, use ``R()``. When a collection is not the right granularity, use ``C(..)``:
|
- To refer to a group of modules in a collection, use ``R()``. When a collection is not the right granularity, use ``C(..)``:
|
||||||
|
|
||||||
- ``Refer to the R(community.kubernetes collection, plugins_in_community.kubernetes) for information on managing kubernetes clusters.``
|
- ``Refer to the R(kubernetes.core collection, plugins_in_kubernetes.core) for information on managing kubernetes clusters.``
|
||||||
- ``The C(win_*) modules (spread across several collections) allow you to manage various aspects of windows hosts.``
|
- ``The C(win_*) modules (spread across several collections) allow you to manage various aspects of windows hosts.``
|
||||||
|
|
||||||
|
|
||||||
|
@ -268,7 +268,7 @@ content in a uniform way:
|
||||||
Documentation fragments
|
Documentation fragments
|
||||||
-----------------------
|
-----------------------
|
||||||
|
|
||||||
If you are writing multiple related modules, they may share common documentation, such as authentication details, file mode settings, ``notes:`` or ``seealso:`` entries. Rather than duplicate that information in each module's ``DOCUMENTATION`` block, you can save it once as a doc_fragment plugin and use it in each module's documentation. In Ansible, shared documentation fragments are contained in a ``ModuleDocFragment`` class in `lib/ansible/plugins/doc_fragments/ <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/doc_fragments>`_ or the equivalent directory in a collection. To include a documentation fragment, add ``extends_documentation_fragment: FRAGMENT_NAME`` in your module documentation. Use the fully qualified collection name for the FRAGMENT_NAME (for example, ``community.kubernetes.k8s_auth_options``).
|
If you are writing multiple related modules, they may share common documentation, such as authentication details, file mode settings, ``notes:`` or ``seealso:`` entries. Rather than duplicate that information in each module's ``DOCUMENTATION`` block, you can save it once as a doc_fragment plugin and use it in each module's documentation. In Ansible, shared documentation fragments are contained in a ``ModuleDocFragment`` class in `lib/ansible/plugins/doc_fragments/ <https://github.com/ansible/ansible/tree/devel/lib/ansible/plugins/doc_fragments>`_ or the equivalent directory in a collection. To include a documentation fragment, add ``extends_documentation_fragment: FRAGMENT_NAME`` in your module documentation. Use the fully qualified collection name for the FRAGMENT_NAME (for example, ``kubernetes.core.k8s_auth_options``).
|
||||||
|
|
||||||
Modules should only use items from a doc fragment if the module will implement all of the interface documented there in a manner that behaves the same as the existing modules which import that fragment. The goal is that items imported from the doc fragment will behave identically when used in another module that imports the doc fragment.
|
Modules should only use items from a doc fragment if the module will implement all of the interface documented there in a manner that behaves the same as the existing modules which import that fragment. The goal is that items imported from the doc fragment will behave identically when used in another module that imports the doc fragment.
|
||||||
|
|
||||||
|
|
|
@ -227,7 +227,7 @@ Modules require different suffixes from other plugins:
|
||||||
.. code-block:: rst
|
.. code-block:: rst
|
||||||
|
|
||||||
:ref:`arista.eos.eos_config <ansible_collections.arista.eos.eos_config_module>`
|
:ref:`arista.eos.eos_config <ansible_collections.arista.eos.eos_config_module>`
|
||||||
:ref:`community.kubernetes.kubectl connection plugin <ansible_collections.community.kubernetes.kubectl_connection>`
|
:ref:`kubernetes.core.kubectl connection plugin <ansible_collections.kubernetes.core.kubectl_connection>`
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
|
|
|
@ -24,13 +24,13 @@ To use the modules, you'll need the following:
|
||||||
Installation
|
Installation
|
||||||
============
|
============
|
||||||
|
|
||||||
The Kubernetes modules are part of the `Ansible Kubernetes collection <https://github.com/ansible-collections/community.kubernetes>`_.
|
The Kubernetes modules are part of the `Ansible Kubernetes collection <https://github.com/ansible-collections/kubernetes.core>`_.
|
||||||
|
|
||||||
To install the collection, run the following:
|
To install the collection, run the following:
|
||||||
|
|
||||||
.. code-block:: bash
|
.. code-block:: bash
|
||||||
|
|
||||||
$ ansible-galaxy collection install community.kubernetes
|
$ ansible-galaxy collection install kubernetes.core
|
||||||
|
|
||||||
|
|
||||||
Authenticating with the API
|
Authenticating with the API
|
||||||
|
@ -45,6 +45,6 @@ To disable SSL certificate verification, set ``verify_ssl`` to false.
|
||||||
Reporting an issue
|
Reporting an issue
|
||||||
==================
|
==================
|
||||||
|
|
||||||
If you find a bug or have a suggestion regarding modules, please file issues at `Ansible Kubernetes collection <https://github.com/ansible-collections/community.kubernetes>`_.
|
If you find a bug or have a suggestion regarding modules, please file issues at `Ansible Kubernetes collection <https://github.com/ansible-collections/kubernetes.core>`_.
|
||||||
If you find a bug regarding OpenShift client, please file issues at `OpenShift REST Client issues <https://github.com/openshift/openshift-restclient-python/issues>`_.
|
If you find a bug regarding OpenShift client, please file issues at `OpenShift REST Client issues <https://github.com/openshift/openshift-restclient-python/issues>`_.
|
||||||
If you find a bug regarding Kubectl binary, please file issues at `Kubectl issue tracker <https://github.com/kubernetes/kubectl>`_
|
If you find a bug regarding Kubectl binary, please file issues at `Kubectl issue tracker <https://github.com/kubernetes/kubectl>`_
|
||||||
|
|
|
@ -30,17 +30,17 @@ To use this Kubernetes dynamic inventory plugin, you need to enable it first by
|
||||||
.. code-block:: ini
|
.. code-block:: ini
|
||||||
|
|
||||||
[inventory]
|
[inventory]
|
||||||
enable_plugins = community.kubernetes.k8s
|
enable_plugins = kubernetes.core.k8s
|
||||||
|
|
||||||
Then, create a file that ends in ``.k8s.yml`` or ``.k8s.yaml`` in your working directory.
|
Then, create a file that ends in ``.k8s.yml`` or ``.k8s.yaml`` in your working directory.
|
||||||
|
|
||||||
The ``community.kubernetes.k8s`` inventory plugin takes in the same authentication information as any other Kubernetes modules.
|
The ``kubernetes.core.k8s`` inventory plugin takes in the same authentication information as any other Kubernetes modules.
|
||||||
|
|
||||||
Here's an example of a valid inventory file:
|
Here's an example of a valid inventory file:
|
||||||
|
|
||||||
.. code-block:: yaml
|
.. code-block:: yaml
|
||||||
|
|
||||||
plugin: community.kubernetes.k8s
|
plugin: kubernetes.core.k8s
|
||||||
|
|
||||||
Executing ``ansible-inventory --list -i <filename>.k8s.yml`` will create a list of Pods that are ready to be configured using Ansible.
|
Executing ``ansible-inventory --list -i <filename>.k8s.yml`` will create a list of Pods that are ready to be configured using Ansible.
|
||||||
|
|
||||||
|
@ -48,7 +48,7 @@ You can also provide the namespace to gather information about specific pods fro
|
||||||
|
|
||||||
.. code-block:: yaml
|
.. code-block:: yaml
|
||||||
|
|
||||||
plugin: community.kubernetes.k8s
|
plugin: kubernetes.core.k8s
|
||||||
connections:
|
connections:
|
||||||
- namespaces:
|
- namespaces:
|
||||||
- test
|
- test
|
||||||
|
|
|
@ -52,7 +52,7 @@ Since Ansible utilizes the Kubernetes API to perform actions, in this use case w
|
||||||
|
|
||||||
To begin, there are a few bits of information we will need. Here you are using Kubeconfig which is pre-configured in your machine. The Kubeconfig is generally located at ``~/.kube/config``. It is highly recommended to store sensitive information such as password, user certificates in a more secure fashion using :ref:`ansible-vault` or using `Ansible Tower credentials <https://docs.ansible.com/ansible-tower/latest/html/userguide/credentials.html>`_.
|
To begin, there are a few bits of information we will need. Here you are using Kubeconfig which is pre-configured in your machine. The Kubeconfig is generally located at ``~/.kube/config``. It is highly recommended to store sensitive information such as password, user certificates in a more secure fashion using :ref:`ansible-vault` or using `Ansible Tower credentials <https://docs.ansible.com/ansible-tower/latest/html/userguide/credentials.html>`_.
|
||||||
|
|
||||||
Now you need to supply the information about the Pod which will be created. Using ``definition`` parameter of the ``community.kubernetes.k8s`` module, you specify `PodTemplate <https://kubernetes.io/docs/concepts/workloads/pods/#pod-templates>`_. This PodTemplate is identical to what you provide to the ``kubectl`` command.
|
Now you need to supply the information about the Pod which will be created. Using ``definition`` parameter of the ``kubernetes.core.k8s`` module, you specify `PodTemplate <https://kubernetes.io/docs/concepts/workloads/pods/#pod-templates>`_. This PodTemplate is identical to what you provide to the ``kubectl`` command.
|
||||||
|
|
||||||
What to expect
|
What to expect
|
||||||
--------------
|
--------------
|
||||||
|
|
|
@ -1,7 +1,7 @@
|
||||||
---
|
---
|
||||||
- hosts: localhost
|
- hosts: localhost
|
||||||
collections:
|
collections:
|
||||||
- community.kubernetes
|
- kubernetes.core
|
||||||
tasks:
|
tasks:
|
||||||
- name: Create a pod
|
- name: Create a pod
|
||||||
k8s:
|
k8s:
|
||||||
|
|
|
@ -1732,12 +1732,12 @@ Getting Kubernetes resource names
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
These filters have migrated to the `community.kubernetes <https://galaxy.ansible.com/community/kubernetes>`_ collection. Follow the installation instructions to install that collection.
|
These filters have migrated to the `kuberernetes.core <https://galaxy.ansible.com/kubernetes/core>`_ collection. Follow the installation instructions to install that collection.
|
||||||
|
|
||||||
Use the "k8s_config_resource_name" filter to obtain the name of a Kubernetes ConfigMap or Secret,
|
Use the "k8s_config_resource_name" filter to obtain the name of a Kubernetes ConfigMap or Secret,
|
||||||
including its hash::
|
including its hash::
|
||||||
|
|
||||||
{{ configmap_resource_definition | community.kubernetes.k8s_config_resource_name }}
|
{{ configmap_resource_definition | kuberernetes.core.k8s_config_resource_name }}
|
||||||
|
|
||||||
This can then be used to reference hashes in Pod specifications::
|
This can then be used to reference hashes in Pod specifications::
|
||||||
|
|
||||||
|
@ -1754,7 +1754,7 @@ This can then be used to reference hashes in Pod specifications::
|
||||||
containers:
|
containers:
|
||||||
- envFrom:
|
- envFrom:
|
||||||
- secretRef:
|
- secretRef:
|
||||||
name: {{ my_secret | community.kubernetes.k8s_config_resource_name }}
|
name: {{ my_secret | kuberernetes.core.k8s_config_resource_name }}
|
||||||
|
|
||||||
.. versionadded:: 2.8
|
.. versionadded:: 2.8
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue