From 22b9b9ce2a4c8a486bdfe6999ba495159c9a2f37 Mon Sep 17 00:00:00 2001 From: gamba47 Date: Wed, 6 Dec 2023 23:52:51 -0300 Subject: [PATCH 01/13] first review --- .../run-application/delete-stateful-set.md | 91 +++++++++++++++++++ 1 file changed, 91 insertions(+) create mode 100644 content/es/docs/tasks/run-application/delete-stateful-set.md diff --git a/content/es/docs/tasks/run-application/delete-stateful-set.md b/content/es/docs/tasks/run-application/delete-stateful-set.md new file mode 100644 index 0000000000..3928cde017 --- /dev/null +++ b/content/es/docs/tasks/run-application/delete-stateful-set.md @@ -0,0 +1,91 @@ +--- +title: Borrar un StatefulSet +content_type: task +weight: 60 +--- + + + +Esta página muestra como se debe eliminar un {{< glossary_tooltip term_id="StatefulSet" >}}. + +## {{% heading "prerequisites" %}} + +- Se asume que se tiene una aplicacion del tipo StatefulSet corrriendo en su cluster. + + + +## Borrando un StatefulSet + +Se puede eliminar un StatefulSet de la misma manera que se eliminan otros recursos en Kubernetes: +use el comando `kubectl delete` y especifique el StatefulSet, usando su nombre o el archivo con el que fue creado. + +```shell +kubectl delete -f +``` + +```shell +kubectl delete statefulsets +``` + +Puede suceder que necesite eliminar los servicios headless asociados despues de eliminar el StatefulSet. + +```shell +kubectl delete service +``` + +Cuando se elimina un StatefulSet utilizando `kubectl`, el StatefulSet escala a 0. +Todos los Pods que eran parte de esta carga de trabajo son eliminados. Si usted quiere eliminar +solo el StatefulSet y no los Pods utilice `--cascade=orphan`. Por ejemplo: + +```shell +kubectl delete -f --cascade=orphan +``` + +Agregando `--cascade=orphan` al comando `kubectl delete`, los Pods administrados por el StatefulSet +dejan de pertenecer al StatefulSet cuando es eliminado. Si los pods tienen una +etiqueta `app.kubernetes.io/name=MyApp` se los puede eliminar de la siguiente manera: + +```shell +kubectl delete pods -l app.kubernetes.io/name=MyApp +``` + +### Volúmenes Persistentes + +Eliminar los Pods de un StatefulSet no va a eliminar los volúmenes asociados. +Esto es para asegurar que se tiene una oportunidad de copiar los datos fuera del volumen +antes de eliminarlo. Borar el PVC después de que los pods esten terminados puede disparar +la eliminacino del Volumen Persistente que hay detrás dependiendo de la clase de almacenamiento +y la política de reclamo. #TODO You should never assume ability to access a volume +after claim deletion. + +{{< note >}} +Tenga cuidado al borrar un PVC ya que puede llevar una pérdida de datos. +{{< /note >}} + +### Eliminación completa de un StatefulSet + +Para eliminar todo en un StatefulSet, incluyendo los pods asociados, +se puede correr una serie de comandos similares a los siguientes: + +```shell +grace=$(kubectl get pods --template '{{.spec.terminationGracePeriodSeconds}}') +kubectl delete statefulset -l app.kubernetes.io/name=MyApp +sleep $grace +kubectl delete pvc -l app.kubernetes.io/name=MyApp + +``` + +En este ejemplo, los Pods tienen la etiqueta `app.kubernetes.io/name=MyApp`, +sustituya la misma por su propia etiqueta. + +### Forzar la eliminación de los Pods de un StatefulSet + +Si encuentra algún pod bloqueado en su StatefulSet en el estado 'Terminating' +o 'Unknow' por un largo período de tiempo, puede ser que necesite intervenir +manualmente para forzar la eliminación del pod del apiserver. +Esta es una tarea potencialmente riesgosa. Visite [Forzar eliminacion de Pods en StatefulSet](/docs/tasks/run-application/force-delete-stateful-set-pod/) +para más detalles. + +## {{% heading "whatsnext" %}} + +Aprenda más sobre [Forzar eliminacion de Pods en StatefulSet](/docs/tasks/run-application/force-delete-stateful-set-pod/). From 4d12b033251021607cb918d02f7c427d20cedfa1 Mon Sep 17 00:00:00 2001 From: gamba47 Date: Wed, 6 Dec 2023 23:55:49 -0300 Subject: [PATCH 02/13] second review --- .../tasks/run-application/delete-stateful-set.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/content/es/docs/tasks/run-application/delete-stateful-set.md b/content/es/docs/tasks/run-application/delete-stateful-set.md index 3928cde017..32f6b8dda8 100644 --- a/content/es/docs/tasks/run-application/delete-stateful-set.md +++ b/content/es/docs/tasks/run-application/delete-stateful-set.md @@ -10,14 +10,14 @@ Esta página muestra como se debe eliminar un {{< glossary_tooltip term_id="Stat ## {{% heading "prerequisites" %}} -- Se asume que se tiene una aplicacion del tipo StatefulSet corrriendo en su cluster. +- Se asume que se tiene una aplicación del tipo StatefulSet corriendo en su clúster. ## Borrando un StatefulSet Se puede eliminar un StatefulSet de la misma manera que se eliminan otros recursos en Kubernetes: -use el comando `kubectl delete` y especifique el StatefulSet, usando su nombre o el archivo con el que fue creado. +Use el comando `kubectl delete` y especifique el StatefulSet, usando su nombre o el archivo con el que fue creado. ```shell kubectl delete -f @@ -27,7 +27,7 @@ kubectl delete -f kubectl delete statefulsets ``` -Puede suceder que necesite eliminar los servicios headless asociados despues de eliminar el StatefulSet. +Puede suceder que necesite eliminar los servicios headless asociados después de eliminar el StatefulSet. ```shell kubectl delete service @@ -53,8 +53,8 @@ kubectl delete pods -l app.kubernetes.io/name=MyApp Eliminar los Pods de un StatefulSet no va a eliminar los volúmenes asociados. Esto es para asegurar que se tiene una oportunidad de copiar los datos fuera del volumen -antes de eliminarlo. Borar el PVC después de que los pods esten terminados puede disparar -la eliminacino del Volumen Persistente que hay detrás dependiendo de la clase de almacenamiento +antes de eliminarlo. Borrar el PVC después de que los pods estén terminados puede disparar +la eliminación del Volumen Persistente que hay detrás dependiendo de la clase de almacenamiento y la política de reclamo. #TODO You should never assume ability to access a volume after claim deletion. @@ -83,9 +83,9 @@ sustituya la misma por su propia etiqueta. Si encuentra algún pod bloqueado en su StatefulSet en el estado 'Terminating' o 'Unknow' por un largo período de tiempo, puede ser que necesite intervenir manualmente para forzar la eliminación del pod del apiserver. -Esta es una tarea potencialmente riesgosa. Visite [Forzar eliminacion de Pods en StatefulSet](/docs/tasks/run-application/force-delete-stateful-set-pod/) +Esta es una tarea potencialmente riesgosa. Visite [Forzar eliminación de Pods en StatefulSet](/docs/tasks/run-application/force-delete-stateful-set-pod/) para más detalles. ## {{% heading "whatsnext" %}} -Aprenda más sobre [Forzar eliminacion de Pods en StatefulSet](/docs/tasks/run-application/force-delete-stateful-set-pod/). +Aprenda más sobre [Forzar eliminación de Pods en StatefulSet](/docs/tasks/run-application/force-delete-stateful-set-pod/). From 15487e73d8b8cb2d9e6ad5e384b863d0b768006c Mon Sep 17 00:00:00 2001 From: gamba47 Date: Thu, 7 Dec 2023 10:46:55 -0300 Subject: [PATCH 03/13] minor fix --- content/es/docs/tasks/run-application/delete-stateful-set.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/es/docs/tasks/run-application/delete-stateful-set.md b/content/es/docs/tasks/run-application/delete-stateful-set.md index 32f6b8dda8..ca96165210 100644 --- a/content/es/docs/tasks/run-application/delete-stateful-set.md +++ b/content/es/docs/tasks/run-application/delete-stateful-set.md @@ -16,7 +16,7 @@ Esta página muestra como se debe eliminar un {{< glossary_tooltip term_id="Stat ## Borrando un StatefulSet -Se puede eliminar un StatefulSet de la misma manera que se eliminan otros recursos en Kubernetes: +Se puede eliminar un StatefulSet de la misma manera que se eliminan el resto de los recursos en Kubernetes: Use el comando `kubectl delete` y especifique el StatefulSet, usando su nombre o el archivo con el que fue creado. ```shell From f124c3bff5902cf7dcc13d0a7c7f433c6c8fae38 Mon Sep 17 00:00:00 2001 From: gamba47 Date: Sat, 9 Dec 2023 20:08:21 -0300 Subject: [PATCH 04/13] start install-kubectl-linux --- .../docs/tasks/tools/install-kubectl-linux.md | 348 ++++++++++++++++++ 1 file changed, 348 insertions(+) create mode 100644 content/es/docs/tasks/tools/install-kubectl-linux.md diff --git a/content/es/docs/tasks/tools/install-kubectl-linux.md b/content/es/docs/tasks/tools/install-kubectl-linux.md new file mode 100644 index 0000000000..ef84fa82a8 --- /dev/null +++ b/content/es/docs/tasks/tools/install-kubectl-linux.md @@ -0,0 +1,348 @@ +--- +title: Instalar y Configurar kubectl en Linux +content_type: task +weight: 10 +--- + +## {{% heading "prerequisites" %}} + +Se debe utilizar la version de kubectl con una minor version de diferencia con +su cluster. Por ejemplo, un cliente con version v{{< skew currentVersion >}} se puede comunicar +con los siguientes versiones de plano de control v{{< skew currentVersionAddMinor -1 >}}, +v{{< skew currentVersionAddMinor 0 >}}, and v{{< skew currentVersionAddMinor 1 >}}. +Utilizar la ultima version compatible de kubectl evita posibles errores. + +## Install kubectl on Linux + +The following methods exist for installing kubectl on Linux: + +- [Install kubectl binary with curl on Linux](#install-kubectl-binary-with-curl-on-linux) +- [Install using native package management](#install-using-native-package-management) +- [Install using other package management](#install-using-other-package-management) + +### Install kubectl binary with curl on Linux + +1. Download the latest release with the command: + + {{< tabs name="download_binary_linux" >}} + {{< tab name="x86-64" codelang="bash" >}} + curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl" + {{< /tab >}} + {{< tab name="ARM64" codelang="bash" >}} + curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/arm64/kubectl" + {{< /tab >}} + {{< /tabs >}} + + {{< note >}} + To download a specific version, replace the `$(curl -L -s https://dl.k8s.io/release/stable.txt)` + portion of the command with the specific version. + + For example, to download version {{< skew currentPatchVersion >}} on Linux x86-64, type: + + ```bash + curl -LO https://dl.k8s.io/release/v{{< skew currentPatchVersion >}}/bin/linux/amd64/kubectl + ``` + + And for Linux ARM64, type: + + ```bash + curl -LO https://dl.k8s.io/release/v{{< skew currentPatchVersion >}}/bin/linux/arm64/kubectl + ``` + + {{< /note >}} + +1. Validate the binary (optional) + + Download the kubectl checksum file: + + {{< tabs name="download_checksum_linux" >}} + {{< tab name="x86-64" codelang="bash" >}} + curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl.sha256" + {{< /tab >}} + {{< tab name="ARM64" codelang="bash" >}} + curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/arm64/kubectl.sha256" + {{< /tab >}} + {{< /tabs >}} + + Validate the kubectl binary against the checksum file: + + ```bash + echo "$(cat kubectl.sha256) kubectl" | sha256sum --check + ``` + + If valid, the output is: + + ```console + kubectl: OK + ``` + + If the check fails, `sha256` exits with nonzero status and prints output similar to: + + ```console + kubectl: FAILED + sha256sum: WARNING: 1 computed checksum did NOT match + ``` + + {{< note >}} + Download the same version of the binary and checksum. + {{< /note >}} + +1. Install kubectl + + ```bash + sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl + ``` + + {{< note >}} + If you do not have root access on the target system, you can still install + kubectl to the `~/.local/bin` directory: + + ```bash + chmod +x kubectl + mkdir -p ~/.local/bin + mv ./kubectl ~/.local/bin/kubectl + # and then append (or prepend) ~/.local/bin to $PATH + ``` + + {{< /note >}} + +1. Test to ensure the version you installed is up-to-date: + + ```bash + kubectl version --client + ``` + + Or use this for detailed view of version: + + ```cmd + kubectl version --client --output=yaml + ``` + +### Install using native package management + +{{< tabs name="kubectl_install" >}} +{{% tab name="Debian-based distributions" %}} + +1. Update the `apt` package index and install packages needed to use the Kubernetes `apt` repository: + + ```shell + sudo apt-get update + # apt-transport-https may be a dummy package; if so, you can skip that package + sudo apt-get install -y apt-transport-https ca-certificates curl + ``` + +2. Download the public signing key for the Kubernetes package repositories. The same signing key is used for all repositories so you can disregard the version in the URL: + + ```shell + curl -fsSL https://pkgs.k8s.io/core:/stable:/{{< param "version" >}}/deb/Release.key | sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg + ``` + +3. Add the appropriate Kubernetes `apt` repository. If you want to use Kubernetes version different than {{< param "version" >}}, + replace {{< param "version" >}} with the desired minor version in the command below: + + ```shell + # This overwrites any existing configuration in /etc/apt/sources.list.d/kubernetes.list + echo 'deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core:/stable:/{{< param "version" >}}/deb/ /' | sudo tee /etc/apt/sources.list.d/kubernetes.list + ``` + +{{< note >}} +To upgrade kubectl to another minor release, you'll need to bump the version in `/etc/apt/sources.list.d/kubernetes.list` before running `apt-get update` and `apt-get upgrade`. This procedure is described in more detail in [Changing The Kubernetes Package Repository](/docs/tasks/administer-cluster/kubeadm/change-package-repository/). +{{< /note >}} + +4. Update `apt` package index, then install kubectl: + + ```shell + sudo apt-get update + sudo apt-get install -y kubectl + ``` + +{{< note >}} +In releases older than Debian 12 and Ubuntu 22.04, `/etc/apt/keyrings` does not exist by default, and can be created using `sudo mkdir -m 755 /etc/apt/keyrings` +{{< /note >}} + +{{% /tab %}} + +{{% tab name="Red Hat-based distributions" %}} + +1. Add the Kubernetes `yum` repository. If you want to use Kubernetes version + different than {{< param "version" >}}, replace {{< param "version" >}} with + the desired minor version in the command below. + + ```bash + # This overwrites any existing configuration in /etc/yum.repos.d/kubernetes.repo + cat <}}/rpm/ + enabled=1 + gpgcheck=1 + gpgkey=https://pkgs.k8s.io/core:/stable:/{{< param "version" >}}/rpm/repodata/repomd.xml.key + EOF + ``` + +{{< note >}} +To upgrade kubectl to another minor release, you'll need to bump the version in `/etc/yum.repos.d/kubernetes.repo` before running `yum update`. This procedure is described in more detail in [Changing The Kubernetes Package Repository](/docs/tasks/administer-cluster/kubeadm/change-package-repository/). +{{< /note >}} + +2. Install kubectl using `yum`: + + ```bash + sudo yum install -y kubectl + ``` + +{{% /tab %}} + +{{% tab name="SUSE-based distributions" %}} + +1. Add the Kubernetes `zypper` repository. If you want to use Kubernetes version + different than {{< param "version" >}}, replace {{< param "version" >}} with + the desired minor version in the command below. + + ```bash + # This overwrites any existing configuration in /etc/zypp/repos.d/kubernetes.repo + cat <}}/rpm/ + enabled=1 + gpgcheck=1 + gpgkey=https://pkgs.k8s.io/core:/stable:/{{< param "version" >}}/rpm/repodata/repomd.xml.key + EOF + ``` + +{{< note >}} +To upgrade kubectl to another minor release, you'll need to bump the version in `/etc/zypp/repos.d/kubernetes.repo` +before running `zypper update`. This procedure is described in more detail in +[Changing The Kubernetes Package Repository](/docs/tasks/administer-cluster/kubeadm/change-package-repository/). +{{< /note >}} + + 2. Install kubectl using `zypper`: + + ```bash + sudo zypper install -y kubectl + ``` + +{{% /tab %}} +{{< /tabs >}} + +### Install using other package management + +{{< tabs name="other_kubectl_install" >}} +{{% tab name="Snap" %}} +If you are on Ubuntu or another Linux distribution that supports the +[snap](https://snapcraft.io/docs/core/install) package manager, kubectl +is available as a [snap](https://snapcraft.io/) application. + +```shell +snap install kubectl --classic +kubectl version --client +``` + +{{% /tab %}} + +{{% tab name="Homebrew" %}} +If you are on Linux and using [Homebrew](https://docs.brew.sh/Homebrew-on-Linux) +package manager, kubectl is available for [installation](https://docs.brew.sh/Homebrew-on-Linux#install). + +```shell +brew install kubectl +kubectl version --client +``` + +{{% /tab %}} + +{{< /tabs >}} + +## Verify kubectl configuration + +{{< include "included/verify-kubectl.md" >}} + +## Optional kubectl configurations and plugins + +### Enable shell autocompletion + +kubectl provides autocompletion support for Bash, Zsh, Fish, and PowerShell, +which can save you a lot of typing. + +Below are the procedures to set up autocompletion for Bash, Fish, and Zsh. + +{{< tabs name="kubectl_autocompletion" >}} +{{< tab name="Bash" include="included/optional-kubectl-configs-bash-linux.md" />}} +{{< tab name="Fish" include="included/optional-kubectl-configs-fish.md" />}} +{{< tab name="Zsh" include="included/optional-kubectl-configs-zsh.md" />}} +{{< /tabs >}} + +### Install `kubectl convert` plugin + +{{< include "included/kubectl-convert-overview.md" >}} + +1. Download the latest release with the command: + + {{< tabs name="download_convert_binary_linux" >}} + {{< tab name="x86-64" codelang="bash" >}} + curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl-convert" + {{< /tab >}} + {{< tab name="ARM64" codelang="bash" >}} + curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/arm64/kubectl-convert" + {{< /tab >}} + {{< /tabs >}} + +1. Validate the binary (optional) + + Download the kubectl-convert checksum file: + + {{< tabs name="download_convert_checksum_linux" >}} + {{< tab name="x86-64" codelang="bash" >}} + curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl-convert.sha256" + {{< /tab >}} + {{< tab name="ARM64" codelang="bash" >}} + curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/arm64/kubectl-convert.sha256" + {{< /tab >}} + {{< /tabs >}} + + Validate the kubectl-convert binary against the checksum file: + + ```bash + echo "$(cat kubectl-convert.sha256) kubectl-convert" | sha256sum --check + ``` + + If valid, the output is: + + ```console + kubectl-convert: OK + ``` + + If the check fails, `sha256` exits with nonzero status and prints output similar to: + + ```console + kubectl-convert: FAILED + sha256sum: WARNING: 1 computed checksum did NOT match + ``` + + {{< note >}} + Download the same version of the binary and checksum. + {{< /note >}} + +1. Install kubectl-convert + + ```bash + sudo install -o root -g root -m 0755 kubectl-convert /usr/local/bin/kubectl-convert + ``` + +1. Verify plugin is successfully installed + + ```shell + kubectl convert --help + ``` + + If you do not see an error, it means the plugin is successfully installed. + +1. After installing the plugin, clean up the installation files: + + ```bash + rm kubectl-convert kubectl-convert.sha256 + ``` + +## {{% heading "whatsnext" %}} + +{{< include "included/kubectl-whats-next.md" >}} From 3df17f629386f84d17f91a2b47d6570a1216a966 Mon Sep 17 00:00:00 2001 From: gamba47 Date: Sat, 9 Dec 2023 23:18:45 -0300 Subject: [PATCH 05/13] adding more lines --- .../docs/tasks/tools/install-kubectl-linux.md | 95 ++++++++++--------- 1 file changed, 48 insertions(+), 47 deletions(-) diff --git a/content/es/docs/tasks/tools/install-kubectl-linux.md b/content/es/docs/tasks/tools/install-kubectl-linux.md index ef84fa82a8..6d3c8dd904 100644 --- a/content/es/docs/tasks/tools/install-kubectl-linux.md +++ b/content/es/docs/tasks/tools/install-kubectl-linux.md @@ -12,17 +12,18 @@ con los siguientes versiones de plano de control v{{< skew currentVersionAddMino v{{< skew currentVersionAddMinor 0 >}}, and v{{< skew currentVersionAddMinor 1 >}}. Utilizar la ultima version compatible de kubectl evita posibles errores. -## Install kubectl on Linux +## Instalar kubectl en Linux -The following methods exist for installing kubectl on Linux: +Existen los siguientes métodos para instalar kubectl en Linux: -- [Install kubectl binary with curl on Linux](#install-kubectl-binary-with-curl-on-linux) -- [Install using native package management](#install-using-native-package-management) -- [Install using other package management](#install-using-other-package-management) +# TODO -> tengo dudas si los links dentro del documento van a funcionar si los nombres no son exactamente iguales! +- [Instalación del binario para Linux de kubectl con Curl](#install-kubectl-binary-with-curl-on-linux) +- [Instalación mediante el administrador de paquetes nativo](#install-using-native-package-management) +- [Instalación usando otro administrador de paquetes](#install-using-other-package-management) -### Install kubectl binary with curl on Linux +### Instalación del binario para Linux de kubectl con Curl -1. Download the latest release with the command: +1. Descargar la ultima versión con el siguiente comando: {{< tabs name="download_binary_linux" >}} {{< tab name="x86-64" codelang="bash" >}} @@ -34,16 +35,16 @@ The following methods exist for installing kubectl on Linux: {{< /tabs >}} {{< note >}} - To download a specific version, replace the `$(curl -L -s https://dl.k8s.io/release/stable.txt)` - portion of the command with the specific version. + Para Descargar una versión específica reemplazar la siguiente parte del comando con la + versión que desea instalar `$(curl -L -s https://dl.k8s.io/release/stable.txt)` - For example, to download version {{< skew currentPatchVersion >}} on Linux x86-64, type: + Por ejemplo, para descargar la versión {{< skew currentPatchVersion >}} en linux x86-64: ```bash curl -LO https://dl.k8s.io/release/v{{< skew currentPatchVersion >}}/bin/linux/amd64/kubectl ``` - And for Linux ARM64, type: + Y para Linux ARM64: ```bash curl -LO https://dl.k8s.io/release/v{{< skew currentPatchVersion >}}/bin/linux/arm64/kubectl @@ -51,9 +52,9 @@ The following methods exist for installing kubectl on Linux: {{< /note >}} -1. Validate the binary (optional) +1. Validación del binario (paso opcional) - Download the kubectl checksum file: + Descargar el archivo checksum: {{< tabs name="download_checksum_linux" >}} {{< tab name="x86-64" codelang="bash" >}} @@ -64,19 +65,19 @@ The following methods exist for installing kubectl on Linux: {{< /tab >}} {{< /tabs >}} - Validate the kubectl binary against the checksum file: + Validar el binario de kubectl contra el archivo checksum: ```bash echo "$(cat kubectl.sha256) kubectl" | sha256sum --check ``` - If valid, the output is: + Si es válido va a obtener la siguiente respuesta: ```console kubectl: OK ``` - If the check fails, `sha256` exits with nonzero status and prints output similar to: + En caso de falla, `sha256` terminará con un estado diferente a cero con una salida similar a esta: ```console kubectl: FAILED @@ -84,41 +85,41 @@ The following methods exist for installing kubectl on Linux: ``` {{< note >}} - Download the same version of the binary and checksum. + Descargue la misma versión del binario y el checksum. {{< /note >}} -1. Install kubectl +1. Instalar kubectl ```bash sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl ``` {{< note >}} - If you do not have root access on the target system, you can still install - kubectl to the `~/.local/bin` directory: + Si no tiene acceso root en el sistema donde se busca instalar, se puede colocar + el binario kubectl en el directorio `~/.local/bin`: ```bash chmod +x kubectl mkdir -p ~/.local/bin mv ./kubectl ~/.local/bin/kubectl - # and then append (or prepend) ~/.local/bin to $PATH + # Y Despues agregue el directorio ~/.local/bin a su $PATH ``` {{< /note >}} -1. Test to ensure the version you installed is up-to-date: +1. Test para asegurar que la versión instalada esta actualizada: ```bash kubectl version --client ``` - Or use this for detailed view of version: + O use lo siguiente para una vista detallada de la versión: ```cmd kubectl version --client --output=yaml ``` -### Install using native package management +### Instalación mediante el administrador de paquetes nativo {{< tabs name="kubectl_install" >}} {{% tab name="Debian-based distributions" %}} @@ -225,13 +226,13 @@ before running `zypper update`. This procedure is described in more detail in {{% /tab %}} {{< /tabs >}} -### Install using other package management +### Instalación usando otro administrador de paquetes {{< tabs name="other_kubectl_install" >}} {{% tab name="Snap" %}} -If you are on Ubuntu or another Linux distribution that supports the -[snap](https://snapcraft.io/docs/core/install) package manager, kubectl -is available as a [snap](https://snapcraft.io/) application. +Si utiliza Ubuntu o alguna distribución que soporte el administrador de +paquetes [snap](https://snapcraft.io/docs/core/install), kubectl +esta disponible como una aplicación de [snap](https://snapcraft.io/). ```shell snap install kubectl --classic @@ -241,8 +242,8 @@ kubectl version --client {{% /tab %}} {{% tab name="Homebrew" %}} -If you are on Linux and using [Homebrew](https://docs.brew.sh/Homebrew-on-Linux) -package manager, kubectl is available for [installation](https://docs.brew.sh/Homebrew-on-Linux#install). +Si utiliza [Homebrew](https://docs.brew.sh/Homebrew-on-Linux) en Linux, +kubectl esta disponible para su [instalación](https://docs.brew.sh/Homebrew-on-Linux#install). ```shell brew install kubectl @@ -253,18 +254,18 @@ kubectl version --client {{< /tabs >}} -## Verify kubectl configuration +## Verificar la configuración de kubectl {{< include "included/verify-kubectl.md" >}} -## Optional kubectl configurations and plugins +## Configuraciones opcionales y plugins de kubectl -### Enable shell autocompletion +### Habilitar el autocompletado en la shell -kubectl provides autocompletion support for Bash, Zsh, Fish, and PowerShell, -which can save you a lot of typing. +Kubectl tiene soporte para autocompletar en Bash, Zsh, Fish y Powershell, +lo que puede agilizar el tipeo. -Below are the procedures to set up autocompletion for Bash, Fish, and Zsh. +A continuación estan los procedimientos para configurarlo en Bash, Fisch y Zsh. {{< tabs name="kubectl_autocompletion" >}} {{< tab name="Bash" include="included/optional-kubectl-configs-bash-linux.md" />}} @@ -272,11 +273,11 @@ Below are the procedures to set up autocompletion for Bash, Fish, and Zsh. {{< tab name="Zsh" include="included/optional-kubectl-configs-zsh.md" />}} {{< /tabs >}} -### Install `kubectl convert` plugin +### Instalar el plugin `kubectl convert` {{< include "included/kubectl-convert-overview.md" >}} -1. Download the latest release with the command: +1. Descargue la última version con el siguiente comando: {{< tabs name="download_convert_binary_linux" >}} {{< tab name="x86-64" codelang="bash" >}} @@ -287,9 +288,9 @@ Below are the procedures to set up autocompletion for Bash, Fish, and Zsh. {{< /tab >}} {{< /tabs >}} -1. Validate the binary (optional) +1. Valide el binario (opcional) - Download the kubectl-convert checksum file: + Descargue el checksum de kubectl-convert: {{< tabs name="download_convert_checksum_linux" >}} {{< tab name="x86-64" codelang="bash" >}} @@ -300,19 +301,19 @@ Below are the procedures to set up autocompletion for Bash, Fish, and Zsh. {{< /tab >}} {{< /tabs >}} - Validate the kubectl-convert binary against the checksum file: + Ahora se puede validar el binario utilizando el checksum: ```bash echo "$(cat kubectl-convert.sha256) kubectl-convert" | sha256sum --check ``` - If valid, the output is: + Si es válido, la salida será: ```console kubectl-convert: OK ``` - If the check fails, `sha256` exits with nonzero status and prints output similar to: + En caso de falla, `sha256` terminará con un estado diferente a cero con una salida similar a esta: ```console kubectl-convert: FAILED @@ -320,22 +321,22 @@ Below are the procedures to set up autocompletion for Bash, Fish, and Zsh. ``` {{< note >}} - Download the same version of the binary and checksum. + Descargue la misma versión del binario y del checksum. {{< /note >}} -1. Install kubectl-convert +1. Instalar kubectl-convert ```bash sudo install -o root -g root -m 0755 kubectl-convert /usr/local/bin/kubectl-convert ``` -1. Verify plugin is successfully installed +1. Verificar si el plugin fue instalado correctamente ```shell kubectl convert --help ``` - If you do not see an error, it means the plugin is successfully installed. + Si no visualiza ningún error quiere decir que el plugin fue isntalado correctamente. 1. After installing the plugin, clean up the installation files: From 4ff70bac00ccf4936ea6b4f9ef86b3e011f6b966 Mon Sep 17 00:00:00 2001 From: gamba47 Date: Sat, 9 Dec 2023 23:39:42 -0300 Subject: [PATCH 06/13] how to install on debian --- .../docs/tasks/tools/install-kubectl-linux.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/content/es/docs/tasks/tools/install-kubectl-linux.md b/content/es/docs/tasks/tools/install-kubectl-linux.md index 6d3c8dd904..9a00a505cc 100644 --- a/content/es/docs/tasks/tools/install-kubectl-linux.md +++ b/content/es/docs/tasks/tools/install-kubectl-linux.md @@ -113,7 +113,7 @@ Existen los siguientes métodos para instalar kubectl en Linux: kubectl version --client ``` - O use lo siguiente para una vista detallada de la versión: + Se puede utilizar lo siguiente para una vista detallada de la versión: ```cmd kubectl version --client --output=yaml @@ -124,7 +124,7 @@ Existen los siguientes métodos para instalar kubectl en Linux: {{< tabs name="kubectl_install" >}} {{% tab name="Debian-based distributions" %}} -1. Update the `apt` package index and install packages needed to use the Kubernetes `apt` repository: +1. Actualice el índice del paquete `apt`, luego instale los paquetes necesarios para Kubernetes: ```shell sudo apt-get update @@ -132,25 +132,25 @@ Existen los siguientes métodos para instalar kubectl en Linux: sudo apt-get install -y apt-transport-https ca-certificates curl ``` -2. Download the public signing key for the Kubernetes package repositories. The same signing key is used for all repositories so you can disregard the version in the URL: +2. Descarge la llave pública firmada para los repositorios de Kubernetes. La misma llave firmada es usada para todos los repositorios por lo que se puede obviarl a versión en la URL: ```shell curl -fsSL https://pkgs.k8s.io/core:/stable:/{{< param "version" >}}/deb/Release.key | sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg ``` -3. Add the appropriate Kubernetes `apt` repository. If you want to use Kubernetes version different than {{< param "version" >}}, - replace {{< param "version" >}} with the desired minor version in the command below: +3. Agregue el repositorio apropiado de Kubernetes. Si usted quisiera una versión de Kubernetes diferente a {{< param "version" >}}, + reemplace {{< param "version" >}} con la versión deseada en el siguiente comando: ```shell - # This overwrites any existing configuration in /etc/apt/sources.list.d/kubernetes.list + # Esto sobrescribe cualquier configuración existente en el archivo /etc/apt/sources.list.d/kubernetes.list echo 'deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core:/stable:/{{< param "version" >}}/deb/ /' | sudo tee /etc/apt/sources.list.d/kubernetes.list ``` {{< note >}} -To upgrade kubectl to another minor release, you'll need to bump the version in `/etc/apt/sources.list.d/kubernetes.list` before running `apt-get update` and `apt-get upgrade`. This procedure is described in more detail in [Changing The Kubernetes Package Repository](/docs/tasks/administer-cluster/kubeadm/change-package-repository/). +Para actualizar kubectl a una minor release diferente, se debe reemplazar la versión en el archivo `/etc/apt/sources.list.d/kubernetes.list` antes de ejecutar `apt-get update` y `apt-get upgrade`. Este procedimiento se describe con mas detalle en [Cambiando el Repositorio de Kubernetes](/docs/tasks/administer-cluster/kubeadm/change-package-repository/). {{< /note >}} -4. Update `apt` package index, then install kubectl: +4. Actualice el índice de `apt`, luego instale kubectl: ```shell sudo apt-get update @@ -158,7 +158,7 @@ To upgrade kubectl to another minor release, you'll need to bump the version in ``` {{< note >}} -In releases older than Debian 12 and Ubuntu 22.04, `/etc/apt/keyrings` does not exist by default, and can be created using `sudo mkdir -m 755 /etc/apt/keyrings` +En versiones anteriores a Debian 12 y Ubuntu 22.04 el directorio `/etc/apt/keyrings` no existe por defecto, puede ser creado usando el comando `sudo mkdir -m 755 /etc/apt/keyrings` {{< /note >}} {{% /tab %}} From 436a25e13e36d454ceec6058820bf7e532d50767 Mon Sep 17 00:00:00 2001 From: gamba47 Date: Sat, 9 Dec 2023 23:46:02 -0300 Subject: [PATCH 07/13] how to install on red hat --- .../es/docs/tasks/tools/install-kubectl-linux.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/content/es/docs/tasks/tools/install-kubectl-linux.md b/content/es/docs/tasks/tools/install-kubectl-linux.md index 9a00a505cc..d041cbf6a0 100644 --- a/content/es/docs/tasks/tools/install-kubectl-linux.md +++ b/content/es/docs/tasks/tools/install-kubectl-linux.md @@ -77,7 +77,7 @@ Existen los siguientes métodos para instalar kubectl en Linux: kubectl: OK ``` - En caso de falla, `sha256` terminará con un estado diferente a cero con una salida similar a esta: + En caso de falla, `sha256` terminará con un estado diferente a cero con una salida similar a: ```console kubectl: FAILED @@ -165,12 +165,12 @@ En versiones anteriores a Debian 12 y Ubuntu 22.04 el directorio `/etc/apt/keyri {{% tab name="Red Hat-based distributions" %}} -1. Add the Kubernetes `yum` repository. If you want to use Kubernetes version - different than {{< param "version" >}}, replace {{< param "version" >}} with - the desired minor version in the command below. +1. Agregue Kubernetes al repositorio `yum`. Si desea usar una versión de Kubernetes + diferente a {{< param "version" >}}, reemplace {{< param "version" >}} con + la versión deseada en el siguiente comando: ```bash - # This overwrites any existing configuration in /etc/yum.repos.d/kubernetes.repo + # Lo siguiente reemplaza cualquier configuración existente en /etc/yum.repos.d/kubernetes.repo cat <}} -To upgrade kubectl to another minor release, you'll need to bump the version in `/etc/yum.repos.d/kubernetes.repo` before running `yum update`. This procedure is described in more detail in [Changing The Kubernetes Package Repository](/docs/tasks/administer-cluster/kubeadm/change-package-repository/). +Para actualizar kubectl a otra versión será necesario modificar la versión en `/etc/yum.repos.d/kubernetes.repo` antes de ejecutar `yum update`. Este procedimiento se describe con más detalle en [Changing The Kubernetes Package Repository](/docs/tasks/administer-cluster/kubeadm/change-package-repository/). {{< /note >}} -2. Install kubectl using `yum`: +2. Instalar kubectl utilizando `yum`: ```bash sudo yum install -y kubectl From cda36aaacd45f9304ae0db13c74084c5a8921966 Mon Sep 17 00:00:00 2001 From: gamba47 Date: Mon, 11 Dec 2023 10:17:10 -0300 Subject: [PATCH 08/13] finish first translation --- .../docs/tasks/tools/install-kubectl-linux.md | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/content/es/docs/tasks/tools/install-kubectl-linux.md b/content/es/docs/tasks/tools/install-kubectl-linux.md index d041cbf6a0..b260ae4dab 100644 --- a/content/es/docs/tasks/tools/install-kubectl-linux.md +++ b/content/es/docs/tasks/tools/install-kubectl-linux.md @@ -138,7 +138,7 @@ Existen los siguientes métodos para instalar kubectl en Linux: curl -fsSL https://pkgs.k8s.io/core:/stable:/{{< param "version" >}}/deb/Release.key | sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg ``` -3. Agregue el repositorio apropiado de Kubernetes. Si usted quisiera una versión de Kubernetes diferente a {{< param "version" >}}, +3. Agregar el repositorio apropiado de Kubernetes. Si usted quisiera una versión de Kubernetes diferente a {{< param "version" >}}, reemplace {{< param "version" >}} con la versión deseada en el siguiente comando: ```shell @@ -165,7 +165,7 @@ En versiones anteriores a Debian 12 y Ubuntu 22.04 el directorio `/etc/apt/keyri {{% tab name="Red Hat-based distributions" %}} -1. Agregue Kubernetes al repositorio `yum`. Si desea usar una versión de Kubernetes +1. Agregar Kubernetes al repositorio `yum`. Si desea usar una versión de Kubernetes diferente a {{< param "version" >}}, reemplace {{< param "version" >}} con la versión deseada en el siguiente comando: @@ -182,7 +182,8 @@ En versiones anteriores a Debian 12 y Ubuntu 22.04 el directorio `/etc/apt/keyri ``` {{< note >}} -Para actualizar kubectl a otra versión será necesario modificar la versión en `/etc/yum.repos.d/kubernetes.repo` antes de ejecutar `yum update`. Este procedimiento se describe con más detalle en [Changing The Kubernetes Package Repository](/docs/tasks/administer-cluster/kubeadm/change-package-repository/). +Para actualizar kubectl a otra versión será necesario modificar la versión en `/etc/yum.repos.d/kubernetes.repo` +antes de ejecutar `yum update`. Este procedimiento se describe con más detalle en [Changing The Kubernetes Package Repository](/docs/tasks/administer-cluster/kubeadm/change-package-repository/). {{< /note >}} 2. Instalar kubectl utilizando `yum`: @@ -195,12 +196,12 @@ Para actualizar kubectl a otra versión será necesario modificar la versión en {{% tab name="SUSE-based distributions" %}} -1. Add the Kubernetes `zypper` repository. If you want to use Kubernetes version - different than {{< param "version" >}}, replace {{< param "version" >}} with - the desired minor version in the command below. +1. Agregar Kubernetes al repositorio `zypper`. Si desea usar una versión de Kubernetes + diferente a {{< param "version" >}}, reemplace {{< param "version" >}} con + la versión deseada en el siguiente comando: ```bash - # This overwrites any existing configuration in /etc/zypp/repos.d/kubernetes.repo + # Lo siguiente reemplaza cualquier configuración existente en /etc/zypp/repos.d/kubernetes.repo cat <}} -To upgrade kubectl to another minor release, you'll need to bump the version in `/etc/zypp/repos.d/kubernetes.repo` -before running `zypper update`. This procedure is described in more detail in -[Changing The Kubernetes Package Repository](/docs/tasks/administer-cluster/kubeadm/change-package-repository/). +Para actualizar kubectl a otra versión será necesario modificar la versión en `/etc/zypp/repos.d/kubernetes.repo` +antes de ejecutar `zypper update`. Este procedimiento se describe con más detalle en [Changing The Kubernetes Package Repository](/docs/tasks/administer-cluster/kubeadm/change-package-repository/). {{< /note >}} - 2. Install kubectl using `zypper`: + 2. Instalar kubectl usando `zypper`: ```bash sudo zypper install -y kubectl @@ -338,7 +338,7 @@ A continuación estan los procedimientos para configurarlo en Bash, Fisch y Zsh. Si no visualiza ningún error quiere decir que el plugin fue isntalado correctamente. -1. After installing the plugin, clean up the installation files: +1. Después de instalar el plugin elimine los archivos de instalación: ```bash rm kubectl-convert kubectl-convert.sha256 From c68dbad724c2f096b4bc3d388aadfde5d9836b44 Mon Sep 17 00:00:00 2001 From: gamba47 Date: Mon, 11 Dec 2023 10:27:35 -0300 Subject: [PATCH 09/13] another grammar revision --- .../docs/tasks/tools/install-kubectl-linux.md | 28 +++++++++---------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/content/es/docs/tasks/tools/install-kubectl-linux.md b/content/es/docs/tasks/tools/install-kubectl-linux.md index b260ae4dab..648213c5c6 100644 --- a/content/es/docs/tasks/tools/install-kubectl-linux.md +++ b/content/es/docs/tasks/tools/install-kubectl-linux.md @@ -6,11 +6,11 @@ weight: 10 ## {{% heading "prerequisites" %}} -Se debe utilizar la version de kubectl con una minor version de diferencia con -su cluster. Por ejemplo, un cliente con version v{{< skew currentVersion >}} se puede comunicar +Se debe utilizar la versión de kubectl con una minor versión de diferencia con +su cluster. Por ejemplo, un cliente con versión v{{< skew currentVersion >}} se puede comunicar con los siguientes versiones de plano de control v{{< skew currentVersionAddMinor -1 >}}, v{{< skew currentVersionAddMinor 0 >}}, and v{{< skew currentVersionAddMinor 1 >}}. -Utilizar la ultima version compatible de kubectl evita posibles errores. +Utilizar la última versión compatible de kubectl evita posibles errores. ## Instalar kubectl en Linux @@ -23,7 +23,7 @@ Existen los siguientes métodos para instalar kubectl en Linux: ### Instalación del binario para Linux de kubectl con Curl -1. Descargar la ultima versión con el siguiente comando: +1. Descargar la última versión con el siguiente comando: {{< tabs name="download_binary_linux" >}} {{< tab name="x86-64" codelang="bash" >}} @@ -102,12 +102,12 @@ Existen los siguientes métodos para instalar kubectl en Linux: chmod +x kubectl mkdir -p ~/.local/bin mv ./kubectl ~/.local/bin/kubectl - # Y Despues agregue el directorio ~/.local/bin a su $PATH + # Y después agregue el directorio ~/.local/bin a su $PATH ``` {{< /note >}} -1. Test para asegurar que la versión instalada esta actualizada: +1. Test para asegurar que la versión instalada está actualizada: ```bash kubectl version --client @@ -132,7 +132,7 @@ Existen los siguientes métodos para instalar kubectl en Linux: sudo apt-get install -y apt-transport-https ca-certificates curl ``` -2. Descarge la llave pública firmada para los repositorios de Kubernetes. La misma llave firmada es usada para todos los repositorios por lo que se puede obviarl a versión en la URL: +2. Descarge la llave pública firmada para los repositorios de Kubernetes. La misma llave firmada es usada para todos los repositorios por lo que se puede obviar la versión en la URL: ```shell curl -fsSL https://pkgs.k8s.io/core:/stable:/{{< param "version" >}}/deb/Release.key | sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg @@ -147,7 +147,7 @@ Existen los siguientes métodos para instalar kubectl en Linux: ``` {{< note >}} -Para actualizar kubectl a una minor release diferente, se debe reemplazar la versión en el archivo `/etc/apt/sources.list.d/kubernetes.list` antes de ejecutar `apt-get update` y `apt-get upgrade`. Este procedimiento se describe con mas detalle en [Cambiando el Repositorio de Kubernetes](/docs/tasks/administer-cluster/kubeadm/change-package-repository/). +Para actualizar kubectl a una minor release diferente, se debe reemplazar la versión en el archivo `/etc/apt/sources.list.d/kubernetes.list` antes de ejecutar `apt-get update` y `apt-get upgrade`. Este procedimiento se describe con más detalle en [Cambiando el Repositorio de Kubernetes](/docs/tasks/administer-cluster/kubeadm/change-package-repository/). {{< /note >}} 4. Actualice el índice de `apt`, luego instale kubectl: @@ -226,12 +226,12 @@ antes de ejecutar `zypper update`. Este procedimiento se describe con más detal {{% /tab %}} {{< /tabs >}} -### Instalación usando otro administrador de paquetes +### Instalación usando otro administrador de páquetes {{< tabs name="other_kubectl_install" >}} {{% tab name="Snap" %}} Si utiliza Ubuntu o alguna distribución que soporte el administrador de -paquetes [snap](https://snapcraft.io/docs/core/install), kubectl +páquetes [snap](https://snapcraft.io/docs/core/install), kubectl esta disponible como una aplicación de [snap](https://snapcraft.io/). ```shell @@ -243,7 +243,7 @@ kubectl version --client {{% tab name="Homebrew" %}} Si utiliza [Homebrew](https://docs.brew.sh/Homebrew-on-Linux) en Linux, -kubectl esta disponible para su [instalación](https://docs.brew.sh/Homebrew-on-Linux#install). +kubectl está disponible para su [instalación](https://docs.brew.sh/Homebrew-on-Linux#install). ```shell brew install kubectl @@ -265,7 +265,7 @@ kubectl version --client Kubectl tiene soporte para autocompletar en Bash, Zsh, Fish y Powershell, lo que puede agilizar el tipeo. -A continuación estan los procedimientos para configurarlo en Bash, Fisch y Zsh. +A continuación están los procedimientos para configurarlo en Bash, Fisch y Zsh. {{< tabs name="kubectl_autocompletion" >}} {{< tab name="Bash" include="included/optional-kubectl-configs-bash-linux.md" />}} @@ -277,7 +277,7 @@ A continuación estan los procedimientos para configurarlo en Bash, Fisch y Zsh. {{< include "included/kubectl-convert-overview.md" >}} -1. Descargue la última version con el siguiente comando: +1. Descargue la última versión con el siguiente comando: {{< tabs name="download_convert_binary_linux" >}} {{< tab name="x86-64" codelang="bash" >}} @@ -336,7 +336,7 @@ A continuación estan los procedimientos para configurarlo en Bash, Fisch y Zsh. kubectl convert --help ``` - Si no visualiza ningún error quiere decir que el plugin fue isntalado correctamente. + Si no visualiza ningún error quiere decir que el plugin fue instalado correctamente. 1. Después de instalar el plugin elimine los archivos de instalación: From 4c33b2936a8daee674ca809d3e4633bc01d9365b Mon Sep 17 00:00:00 2001 From: gamba47 Date: Mon, 11 Dec 2023 10:32:04 -0300 Subject: [PATCH 10/13] remove file from another branch --- .../run-application/delete-stateful-set.md | 91 ------------------- 1 file changed, 91 deletions(-) delete mode 100644 content/es/docs/tasks/run-application/delete-stateful-set.md diff --git a/content/es/docs/tasks/run-application/delete-stateful-set.md b/content/es/docs/tasks/run-application/delete-stateful-set.md deleted file mode 100644 index ca96165210..0000000000 --- a/content/es/docs/tasks/run-application/delete-stateful-set.md +++ /dev/null @@ -1,91 +0,0 @@ ---- -title: Borrar un StatefulSet -content_type: task -weight: 60 ---- - - - -Esta página muestra como se debe eliminar un {{< glossary_tooltip term_id="StatefulSet" >}}. - -## {{% heading "prerequisites" %}} - -- Se asume que se tiene una aplicación del tipo StatefulSet corriendo en su clúster. - - - -## Borrando un StatefulSet - -Se puede eliminar un StatefulSet de la misma manera que se eliminan el resto de los recursos en Kubernetes: -Use el comando `kubectl delete` y especifique el StatefulSet, usando su nombre o el archivo con el que fue creado. - -```shell -kubectl delete -f -``` - -```shell -kubectl delete statefulsets -``` - -Puede suceder que necesite eliminar los servicios headless asociados después de eliminar el StatefulSet. - -```shell -kubectl delete service -``` - -Cuando se elimina un StatefulSet utilizando `kubectl`, el StatefulSet escala a 0. -Todos los Pods que eran parte de esta carga de trabajo son eliminados. Si usted quiere eliminar -solo el StatefulSet y no los Pods utilice `--cascade=orphan`. Por ejemplo: - -```shell -kubectl delete -f --cascade=orphan -``` - -Agregando `--cascade=orphan` al comando `kubectl delete`, los Pods administrados por el StatefulSet -dejan de pertenecer al StatefulSet cuando es eliminado. Si los pods tienen una -etiqueta `app.kubernetes.io/name=MyApp` se los puede eliminar de la siguiente manera: - -```shell -kubectl delete pods -l app.kubernetes.io/name=MyApp -``` - -### Volúmenes Persistentes - -Eliminar los Pods de un StatefulSet no va a eliminar los volúmenes asociados. -Esto es para asegurar que se tiene una oportunidad de copiar los datos fuera del volumen -antes de eliminarlo. Borrar el PVC después de que los pods estén terminados puede disparar -la eliminación del Volumen Persistente que hay detrás dependiendo de la clase de almacenamiento -y la política de reclamo. #TODO You should never assume ability to access a volume -after claim deletion. - -{{< note >}} -Tenga cuidado al borrar un PVC ya que puede llevar una pérdida de datos. -{{< /note >}} - -### Eliminación completa de un StatefulSet - -Para eliminar todo en un StatefulSet, incluyendo los pods asociados, -se puede correr una serie de comandos similares a los siguientes: - -```shell -grace=$(kubectl get pods --template '{{.spec.terminationGracePeriodSeconds}}') -kubectl delete statefulset -l app.kubernetes.io/name=MyApp -sleep $grace -kubectl delete pvc -l app.kubernetes.io/name=MyApp - -``` - -En este ejemplo, los Pods tienen la etiqueta `app.kubernetes.io/name=MyApp`, -sustituya la misma por su propia etiqueta. - -### Forzar la eliminación de los Pods de un StatefulSet - -Si encuentra algún pod bloqueado en su StatefulSet en el estado 'Terminating' -o 'Unknow' por un largo período de tiempo, puede ser que necesite intervenir -manualmente para forzar la eliminación del pod del apiserver. -Esta es una tarea potencialmente riesgosa. Visite [Forzar eliminación de Pods en StatefulSet](/docs/tasks/run-application/force-delete-stateful-set-pod/) -para más detalles. - -## {{% heading "whatsnext" %}} - -Aprenda más sobre [Forzar eliminación de Pods en StatefulSet](/docs/tasks/run-application/force-delete-stateful-set-pod/). From 02f2d6067a13b4350855ec47aa65a571f254919b Mon Sep 17 00:00:00 2001 From: Emilano Vazquez Date: Thu, 14 Dec 2023 19:11:27 -0300 Subject: [PATCH 11/13] Apply suggestions from code review MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Suggestions accepted! Co-authored-by: Rodolfo Martínez Vega --- .../docs/tasks/tools/install-kubectl-linux.md | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/content/es/docs/tasks/tools/install-kubectl-linux.md b/content/es/docs/tasks/tools/install-kubectl-linux.md index 648213c5c6..f5c5c63ec1 100644 --- a/content/es/docs/tasks/tools/install-kubectl-linux.md +++ b/content/es/docs/tasks/tools/install-kubectl-linux.md @@ -7,19 +7,18 @@ weight: 10 ## {{% heading "prerequisites" %}} Se debe utilizar la versión de kubectl con una minor versión de diferencia con -su cluster. Por ejemplo, un cliente con versión v{{< skew currentVersion >}} se puede comunicar -con los siguientes versiones de plano de control v{{< skew currentVersionAddMinor -1 >}}, -v{{< skew currentVersionAddMinor 0 >}}, and v{{< skew currentVersionAddMinor 1 >}}. +tu cluster. Por ejemplo, un cliente con versión v{{< skew currentVersion >}} se puede comunicar +con las siguientes versiones de plano de control v{{< skew currentVersionAddMinor -1 >}}, +v{{< skew currentVersionAddMinor 0 >}} y v{{< skew currentVersionAddMinor 1 >}}. Utilizar la última versión compatible de kubectl evita posibles errores. ## Instalar kubectl en Linux Existen los siguientes métodos para instalar kubectl en Linux: -# TODO -> tengo dudas si los links dentro del documento van a funcionar si los nombres no son exactamente iguales! -- [Instalación del binario para Linux de kubectl con Curl](#install-kubectl-binary-with-curl-on-linux) -- [Instalación mediante el administrador de paquetes nativo](#install-using-native-package-management) -- [Instalación usando otro administrador de paquetes](#install-using-other-package-management) +- [Instalación del binario para Linux de kubectl con Curl](#instalación-del-binario-para-linux-de-kubectl-con-curl) +- [Instalación mediante el administrador de paquetes nativo](#instalación-mediante-el-administrador-de-paquetes-nativo) +- [Instalación usando otro administrador de paquetes](#instalación-usando-otro-administrador-de-paquetes) ### Instalación del binario para Linux de kubectl con Curl @@ -226,7 +225,7 @@ antes de ejecutar `zypper update`. Este procedimiento se describe con más detal {{% /tab %}} {{< /tabs >}} -### Instalación usando otro administrador de páquetes +### Instalación usando otro administrador de paquetes {{< tabs name="other_kubectl_install" >}} {{% tab name="Snap" %}} @@ -265,7 +264,7 @@ kubectl version --client Kubectl tiene soporte para autocompletar en Bash, Zsh, Fish y Powershell, lo que puede agilizar el tipeo. -A continuación están los procedimientos para configurarlo en Bash, Fisch y Zsh. +A continuación están los procedimientos para configurarlo en Bash, Fish y Zsh. {{< tabs name="kubectl_autocompletion" >}} {{< tab name="Bash" include="included/optional-kubectl-configs-bash-linux.md" />}} From 627ddfec2452b4a5e968f15cfc05a54726faa3cc Mon Sep 17 00:00:00 2001 From: Emilano Vazquez Date: Fri, 15 Dec 2023 16:03:33 -0300 Subject: [PATCH 12/13] Apply suggestions from code review MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Suggestions accepted Co-authored-by: Rodolfo Martínez Vega --- .../docs/tasks/tools/install-kubectl-linux.md | 48 +++++++++---------- 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/content/es/docs/tasks/tools/install-kubectl-linux.md b/content/es/docs/tasks/tools/install-kubectl-linux.md index f5c5c63ec1..b91c55d12a 100644 --- a/content/es/docs/tasks/tools/install-kubectl-linux.md +++ b/content/es/docs/tasks/tools/install-kubectl-linux.md @@ -34,7 +34,7 @@ Existen los siguientes métodos para instalar kubectl en Linux: {{< /tabs >}} {{< note >}} - Para Descargar una versión específica reemplazar la siguiente parte del comando con la + Para descargar una versión específica reemplaza la siguiente parte del comando con la versión que desea instalar `$(curl -L -s https://dl.k8s.io/release/stable.txt)` Por ejemplo, para descargar la versión {{< skew currentPatchVersion >}} en linux x86-64: @@ -70,7 +70,7 @@ Existen los siguientes métodos para instalar kubectl en Linux: echo "$(cat kubectl.sha256) kubectl" | sha256sum --check ``` - Si es válido va a obtener la siguiente respuesta: + Si es válido, va a obtener la siguiente respuesta: ```console kubectl: OK @@ -84,7 +84,7 @@ Existen los siguientes métodos para instalar kubectl en Linux: ``` {{< note >}} - Descargue la misma versión del binario y el checksum. + Descarga la misma versión del binario y el checksum. {{< /note >}} 1. Instalar kubectl @@ -94,14 +94,14 @@ Existen los siguientes métodos para instalar kubectl en Linux: ``` {{< note >}} - Si no tiene acceso root en el sistema donde se busca instalar, se puede colocar + Si no tienes acceso root en el sistema donde se busca instalar, puedes colocar el binario kubectl en el directorio `~/.local/bin`: ```bash chmod +x kubectl mkdir -p ~/.local/bin mv ./kubectl ~/.local/bin/kubectl - # Y después agregue el directorio ~/.local/bin a su $PATH + # Y después agrega el directorio ~/.local/bin a tu $PATH ``` {{< /note >}} @@ -112,7 +112,7 @@ Existen los siguientes métodos para instalar kubectl en Linux: kubectl version --client ``` - Se puede utilizar lo siguiente para una vista detallada de la versión: + O puedes utilizar lo siguiente para una vista detallada de la versión: ```cmd kubectl version --client --output=yaml @@ -123,7 +123,7 @@ Existen los siguientes métodos para instalar kubectl en Linux: {{< tabs name="kubectl_install" >}} {{% tab name="Debian-based distributions" %}} -1. Actualice el índice del paquete `apt`, luego instale los paquetes necesarios para Kubernetes: +1. Actualiza el índice del paquete `apt`, luego instala los paquetes necesarios para Kubernetes: ```shell sudo apt-get update @@ -131,13 +131,13 @@ Existen los siguientes métodos para instalar kubectl en Linux: sudo apt-get install -y apt-transport-https ca-certificates curl ``` -2. Descarge la llave pública firmada para los repositorios de Kubernetes. La misma llave firmada es usada para todos los repositorios por lo que se puede obviar la versión en la URL: +2. Descarga la llave pública firmada para los repositorios de Kubernetes. La misma llave firmada es usada para todos los repositorios por lo que se puede obviar la versión en la URL: ```shell curl -fsSL https://pkgs.k8s.io/core:/stable:/{{< param "version" >}}/deb/Release.key | sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg ``` -3. Agregar el repositorio apropiado de Kubernetes. Si usted quisiera una versión de Kubernetes diferente a {{< param "version" >}}, +3. Agregar el repositorio apropiado de Kubernetes. Si quieres una versión de Kubernetes diferente a {{< param "version" >}}, reemplace {{< param "version" >}} con la versión deseada en el siguiente comando: ```shell @@ -149,7 +149,7 @@ Existen los siguientes métodos para instalar kubectl en Linux: Para actualizar kubectl a una minor release diferente, se debe reemplazar la versión en el archivo `/etc/apt/sources.list.d/kubernetes.list` antes de ejecutar `apt-get update` y `apt-get upgrade`. Este procedimiento se describe con más detalle en [Cambiando el Repositorio de Kubernetes](/docs/tasks/administer-cluster/kubeadm/change-package-repository/). {{< /note >}} -4. Actualice el índice de `apt`, luego instale kubectl: +4. Actualiza el índice de `apt`, luego instala kubectl: ```shell sudo apt-get update @@ -164,8 +164,8 @@ En versiones anteriores a Debian 12 y Ubuntu 22.04 el directorio `/etc/apt/keyri {{% tab name="Red Hat-based distributions" %}} -1. Agregar Kubernetes al repositorio `yum`. Si desea usar una versión de Kubernetes - diferente a {{< param "version" >}}, reemplace {{< param "version" >}} con +1. Agregar Kubernetes al repositorio `yum`. Si deseas usar una versión de Kubernetes + diferente a {{< param "version" >}}, reemplaza {{< param "version" >}} con la versión deseada en el siguiente comando: ```bash @@ -181,7 +181,7 @@ En versiones anteriores a Debian 12 y Ubuntu 22.04 el directorio `/etc/apt/keyri ``` {{< note >}} -Para actualizar kubectl a otra versión será necesario modificar la versión en `/etc/yum.repos.d/kubernetes.repo` +Para actualizar kubectl a otra versión, será necesario modificar la versión en `/etc/yum.repos.d/kubernetes.repo` antes de ejecutar `yum update`. Este procedimiento se describe con más detalle en [Changing The Kubernetes Package Repository](/docs/tasks/administer-cluster/kubeadm/change-package-repository/). {{< /note >}} @@ -195,8 +195,8 @@ antes de ejecutar `yum update`. Este procedimiento se describe con más detalle {{% tab name="SUSE-based distributions" %}} -1. Agregar Kubernetes al repositorio `zypper`. Si desea usar una versión de Kubernetes - diferente a {{< param "version" >}}, reemplace {{< param "version" >}} con +1. Agregar Kubernetes al repositorio `zypper`. Si deseas usar una versión de Kubernetes + diferente a {{< param "version" >}}, reemplaza {{< param "version" >}} con la versión deseada en el siguiente comando: ```bash @@ -229,9 +229,9 @@ antes de ejecutar `zypper update`. Este procedimiento se describe con más detal {{< tabs name="other_kubectl_install" >}} {{% tab name="Snap" %}} -Si utiliza Ubuntu o alguna distribución que soporte el administrador de +Si utilizas Ubuntu o alguna distribución que soporte el administrador de páquetes [snap](https://snapcraft.io/docs/core/install), kubectl -esta disponible como una aplicación de [snap](https://snapcraft.io/). +está disponible como una aplicación de [snap](https://snapcraft.io/). ```shell snap install kubectl --classic @@ -241,7 +241,7 @@ kubectl version --client {{% /tab %}} {{% tab name="Homebrew" %}} -Si utiliza [Homebrew](https://docs.brew.sh/Homebrew-on-Linux) en Linux, +Si utilizas [Homebrew](https://docs.brew.sh/Homebrew-on-Linux) en Linux, kubectl está disponible para su [instalación](https://docs.brew.sh/Homebrew-on-Linux#install). ```shell @@ -268,7 +268,7 @@ A continuación están los procedimientos para configurarlo en Bash, Fish y Zsh. {{< tabs name="kubectl_autocompletion" >}} {{< tab name="Bash" include="included/optional-kubectl-configs-bash-linux.md" />}} -{{< tab name="Fish" include="included/optional-kubectl-configs-fish.md" />}} + {{< tab name="Zsh" include="included/optional-kubectl-configs-zsh.md" />}} {{< /tabs >}} @@ -276,7 +276,7 @@ A continuación están los procedimientos para configurarlo en Bash, Fish y Zsh. {{< include "included/kubectl-convert-overview.md" >}} -1. Descargue la última versión con el siguiente comando: +1. Descarga la última versión con el siguiente comando: {{< tabs name="download_convert_binary_linux" >}} {{< tab name="x86-64" codelang="bash" >}} @@ -287,9 +287,9 @@ A continuación están los procedimientos para configurarlo en Bash, Fish y Zsh. {{< /tab >}} {{< /tabs >}} -1. Valide el binario (opcional) +1. Valida el binario (opcional) - Descargue el checksum de kubectl-convert: + Descarga el checksum de kubectl-convert: {{< tabs name="download_convert_checksum_linux" >}} {{< tab name="x86-64" codelang="bash" >}} @@ -335,9 +335,9 @@ A continuación están los procedimientos para configurarlo en Bash, Fish y Zsh. kubectl convert --help ``` - Si no visualiza ningún error quiere decir que el plugin fue instalado correctamente. + Si no visualizas ningún error quiere decir que el plugin fue instalado correctamente. -1. Después de instalar el plugin elimine los archivos de instalación: +1. Después de instalar el plugin elimina los archivos de instalación: ```bash rm kubectl-convert kubectl-convert.sha256 From e0f5a4056202f7a0c502d83c5aab6375d9218bd5 Mon Sep 17 00:00:00 2001 From: gamba47 Date: Tue, 19 Dec 2023 13:54:34 -0300 Subject: [PATCH 13/13] Add optional fish autocompletion line --- content/es/docs/tasks/tools/install-kubectl-linux.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/es/docs/tasks/tools/install-kubectl-linux.md b/content/es/docs/tasks/tools/install-kubectl-linux.md index b91c55d12a..61ffdee8ac 100644 --- a/content/es/docs/tasks/tools/install-kubectl-linux.md +++ b/content/es/docs/tasks/tools/install-kubectl-linux.md @@ -268,7 +268,7 @@ A continuación están los procedimientos para configurarlo en Bash, Fish y Zsh. {{< tabs name="kubectl_autocompletion" >}} {{< tab name="Bash" include="included/optional-kubectl-configs-bash-linux.md" />}} - +{{< tab name="Fish" include="included/optional-kubectl-configs-fish.md" />}} {{< tab name="Zsh" include="included/optional-kubectl-configs-zsh.md" />}} {{< /tabs >}}