1
0
mirror of https://github.com/minio/docs.git synced 2025-07-02 05:02:40 +03:00
Files
docs/source/reference/kubectl-minio-plugin/kubectl-minio-init.rst
Cesar Celis Hernandez d96f3ee959 Correcting Repository Link (#1032)
### Objective:

To set the correct repository in our Official Documentation.

### Related:

To fix: https://github.com/minio/operator/issues/1453

### Explanation:

TBD
2023-10-10 13:02:03 -04:00

158 lines
4.6 KiB
ReStructuredText

.. _kubectl-minio-init:
=========================
``kubectl minio init``
=========================
.. default-domain:: minio
.. contents:: Table of Contents
:local:
:depth: 2
.. mc:: kubectl minio init
Description
-----------
.. start-kubectl-minio-init-desc
The :mc:`kubectl minio init` command initialize the MinIO Operator.
.. end-kubectl-minio-init-desc
If the Kubernetes cluster has an existing MinIO Operator installation, this command upgrades the Operator to match the MinIO plugin version.
For more information on upgrading the MinIO Operator, see :ref:`minio-k8s-upgrade-minio-operator`.
Syntax
------
.. tab-set::
.. tab-item:: EXAMPLE
The following command initializes a new MinIO Operator deployment running |operator-version-stable|.
.. code-block:: shell
:class: copyable
kubectl minio init
.. tab-item:: SYNTAX
The command has the following syntax:
.. code-block:: shell
:class: copyable
kubectl minio init \
[--cluster-domain] \
[--console-image] \
[--console-tls] \
[--default-kes-image] \
[--default-minio-image] \
[--image] \
[--image-pull-secret] \
[--namespace] \
[--namespace-to-watch] \
[--output] \
[--prometheus-name] \
[--prometheus-namespace]
Flags
-----
..
Default values update frequently and can be found in the following files:
https://github.com/minio/operator/blob/master/kubectl-minio/cmd/init.go
https://github.com/minio/operator/blob/master/kubectl-minio/cmd/helpers/constants.go
For minio/console, run ``kubectl minio init -o | grep minio/console``
The command supports the following flags:
.. mc-cmd:: --cluster-domain
:optional:
The domain name to use when configuring the DNS hostname of the operator.
Defaults to ``cluster.local``.
.. mc-cmd:: --console-image
:optional:
The image to use when deploying the :minio-git:`Operator Console <operator>` in Operator mode, where administrators can create and manage MinIO tenants using a Graphical User Interface.
Defaults to the `version bundled in variable DefaultOperatorImage for the matching Operator release <https://github.com/minio/operator/blob/master/kubectl-minio/cmd/helpers/constants.go>`__.
.. mc-cmd:: --console-tls
:optional:
.. versionadded:: 4.5.6
Enables TLS for the Operator Console.
Disabled by default.
.. mc-cmd:: --default-kes-image
:optional:
The default :minio-git:`kes <kes>` image to use when creating a new MinIO tenant.
Defaults to the `version bundled in variable DefaultKESImage for the matching Operator release <https://github.com/minio/operator/blob/master/kubectl-minio/cmd/helpers/constants.go>`__.
.. mc-cmd:: --default-minio-image
:optional:
The default :minio-git:`minio <minio>` image to use when creating a new MinIO tenant.
Defaults to the `version bundled in variable DefaultTenantImage for the matching Operator release <https://github.com/minio/operator/blob/master/kubectl-minio/cmd/helpers/constants.go>`__.
.. mc-cmd:: --image
:optional:
The image to use for deploying the operator.
Defaults to the :minio-git:`latest release of the operator <operator/releases/latest>`.
.. mc-cmd:: --image-pull-secret
:optional:
Secret key for use with pulling the :mc-cmd:`~kubectl minio init --image`.
The MinIO-hosted ``minio/operator`` image is *not* password protected.
This option is only required for non-MinIO image sources which are password protected.
.. mc-cmd:: --namespace
:optional:
The namespace into which to deploy the operator.
Defaults to ``minio-operator``.
.. mc-cmd:: --namespace-to-watch
:optional:
The namespace which the operator watches for MinIO tenants.
Defaults to ``""`` for *all namespaces*.
.. mc-cmd:: --output
:optional:
Performs a dry run and outputs the generated YAML to ``STDOUT``.
Use this option to customize the YAML and apply it manually using ``kubectl apply -f <FILE>``.
.. mc-cmd:: --prometheus-name
:optional:
The name of the Prometheus service managed by the Prometheus Operator.
Defaults to ``PROMETHEUS_NAME``
.. mc-cmd:: --prometheus-namespace
:optional:
The namespace into which to deploy Prometheus.
Defaults to ``PROMETHEUS_NAMESPACE``
.. mc-cmd:: --sts
:optional:
Enable Operator sts (v1alpha1)
.. versionadded:: 5.0.0