Updated with Changes From Main
Signed-off-by: Adithya Krishna <aadithya794@gmail.com>
This commit is contained in:
Adithya Krishna
@@ -0,0 +1,6 @@
|
||||
---
|
||||
title: "Herramientas incluidas"
|
||||
description: "Fragmentos que se incluirán en las paginas principaldes de kubectl-installs-*."
|
||||
headless: true
|
||||
toc_hide: true
|
||||
---
|
||||
@@ -0,0 +1,244 @@
|
||||
---
|
||||
reviewers:
|
||||
title: Instalar y configurar kubectl en Linux
|
||||
content_type: task
|
||||
weight: 10
|
||||
card:
|
||||
name: tasks
|
||||
weight: 20
|
||||
title: Instalar kubectl en Linux
|
||||
---
|
||||
|
||||
## {{% heading "prerequisites" %}}
|
||||
|
||||
Debes usar una versión de kubectl que esté dentro de una diferencia de versión menor de tu clúster. Por ejemplo, un v{{< skew latestVersion >}} La cliente puede comunicarse con v{{< skew prevMinorVersion >}}, v{{< skew latestVersion >}}, y v{{< skew nextMinorVersion >}} aviones de control.
|
||||
El uso de la última versión de kubectl ayuda a evitar problemas imprevistos.
|
||||
|
||||
## Instalar kubectl en Linux
|
||||
|
||||
Existen los siguientes métodos para instalar kubectl en Linux:
|
||||
|
||||
- [Instale kubectl binary con curl en Linux](#install-kubectl-binary-with-curl-on-linux)
|
||||
- [Instalar usando la administración de paquetes nativa](#install-using-native-package-management)
|
||||
- [Instalar usando otra administración de paquetes](#install-using-other-package-management)
|
||||
|
||||
### Instale kubectl binary con curl en Linux
|
||||
|
||||
1. Descargue la última versión con el comando:
|
||||
|
||||
```bash
|
||||
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
|
||||
```
|
||||
|
||||
{{< note >}}
|
||||
Para descargar una versión específica, reemplace el `$(curl -L -s https://dl.k8s.io/release/stable.txt)` parte del comando con la versión específica.
|
||||
|
||||
Por ejemplo, para descargar la versión {{< param "fullversion" >}} en Linux, escriba:
|
||||
|
||||
```bash
|
||||
curl -LO https://dl.k8s.io/release/{{< param "fullversion" >}}/bin/linux/amd64/kubectl
|
||||
```
|
||||
{{< /note >}}
|
||||
|
||||
1. Validar el binario (opcional)
|
||||
|
||||
Descargue el archivo de suma de comprobación de kubectl:
|
||||
|
||||
```bash
|
||||
curl -LO "https://dl.k8s.io/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl.sha256"
|
||||
```
|
||||
|
||||
Valide el binario kubectl con el archivo de suma de comprobación:
|
||||
|
||||
```bash
|
||||
echo "$(<kubectl.sha256) kubectl" | sha256sum --check
|
||||
```
|
||||
|
||||
Si es válido, la salida es:
|
||||
|
||||
```console
|
||||
kubectl: OK
|
||||
```
|
||||
|
||||
Si la comprobación falla, `sha256` sale con un estado distinto de cero e imprime una salida similar a:
|
||||
|
||||
```bash
|
||||
kubectl: FAILED
|
||||
sha256sum: WARNING: 1 computed checksum did NOT match
|
||||
```
|
||||
|
||||
{{< note >}}
|
||||
Descargue la misma versión del binario y la suma de comprobación.
|
||||
{{< /note >}}
|
||||
|
||||
1. Instalar kubectl
|
||||
|
||||
```bash
|
||||
sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl
|
||||
```
|
||||
|
||||
{{< note >}}
|
||||
Si no tiene acceso de root en el sistema de destino, aún puede instalar kubectl en el `~/.local/bin` directorio:
|
||||
|
||||
```bash
|
||||
chmod +x kubectl
|
||||
mkdir -p ~/.local/bin/kubectl
|
||||
mv ./kubectl ~/.local/bin/kubectl
|
||||
# y luego agrega ~/.local/bin/kubectl para $PATH
|
||||
```
|
||||
|
||||
{{< /note >}}
|
||||
|
||||
1. Pruebe para asegurarse de que la versión que instaló esté actualizada:
|
||||
|
||||
```bash
|
||||
kubectl version --client
|
||||
```
|
||||
|
||||
### Instalar usando la administración de paquetes nativa
|
||||
|
||||
{{< tabs name="kubectl_install" >}}
|
||||
{{% tab name="Debian-based distributions" %}}
|
||||
|
||||
1. Actualizar el `apt` índice de paquetes e instale los paquetes necesarios para usar Kubernetes `apt` repositorio:
|
||||
|
||||
```shell
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y apt-transport-https ca-certificates curl
|
||||
```
|
||||
|
||||
2. Descargue la clave de firma pública de Google Cloud:
|
||||
|
||||
```shell
|
||||
sudo curl -fsSLo /usr/share/keyrings/kubernetes-archive-keyring.gpg https://packages.cloud.google.com/apt/doc/apt-key.gpg
|
||||
```
|
||||
|
||||
3. Agregue el repositorio `apt` de Kubernetes:
|
||||
|
||||
```shell
|
||||
echo "deb [signed-by=/usr/share/keyrings/kubernetes-archive-keyring.gpg] https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee /etc/apt/sources.list.d/kubernetes.list
|
||||
```
|
||||
|
||||
4. Actualice el índice del paquete `apt` con el nuevo repositorio e instale kubectl:
|
||||
|
||||
```shell
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y kubectl
|
||||
```
|
||||
|
||||
{{% /tab %}}
|
||||
|
||||
{{< tab name="Red Hat-based distributions" codelang="bash" >}}
|
||||
cat <<EOF > /etc/yum.repos.d/kubernetes.repo
|
||||
[kubernetes]
|
||||
name=Kubernetes
|
||||
baseurl=https://packages.cloud.google.com/yum/repos/kubernetes-el7-x86_64
|
||||
enabled=1
|
||||
gpgcheck=1
|
||||
repo_gpgcheck=1
|
||||
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
|
||||
EOF
|
||||
yum install -y kubectl
|
||||
{{< /tab >}}
|
||||
{{< /tabs >}}
|
||||
|
||||
### Instalar usando otra administración de paquetes
|
||||
|
||||
{{< tabs name="other_kubectl_install" >}}
|
||||
{{% tab name="Snap" %}}
|
||||
Si está en Ubuntu u otra distribución de Linux que admita [snap](https://snapcraft.io/docs/core/install) administrador de paquetes, kubectl está disponible como [snap](https://snapcraft.io/) solicitud.
|
||||
|
||||
```shell
|
||||
snap install kubectl --classic
|
||||
kubectl version --client
|
||||
```
|
||||
|
||||
{{% /tab %}}
|
||||
|
||||
{{% tab name="Homebrew" %}}
|
||||
Si está en Linux y usa [Homebrew](https://docs.brew.sh/Homebrew-on-Linux) administrador de paquetes, kubectl está disponible para [installation](https://docs.brew.sh/Homebrew-on-Linux#install).
|
||||
|
||||
```shell
|
||||
brew install kubectl
|
||||
kubectl version --client
|
||||
```
|
||||
|
||||
{{% /tab %}}
|
||||
|
||||
{{< /tabs >}}
|
||||
|
||||
## Verificar la configuración de kubectl
|
||||
|
||||
{{< include "included/verify-kubectl.md" >}}
|
||||
|
||||
## Complementos y configuraciones opcionales de kubectl
|
||||
|
||||
### Habilitar el autocompletado de shell
|
||||
|
||||
kubectl proporciona soporte de autocompletado para Bash y Zsh, lo que puede ahorrarle mucho escribir.
|
||||
|
||||
A continuación, se muestran los procedimientos para configurar el autocompletado para Bash y Zsh.
|
||||
|
||||
{{< tabs name="kubectl_autocompletion" >}}
|
||||
{{< tab name="Bash" include="included/optional-kubectl-configs-bash-linux.md" />}}
|
||||
{{< tab name="Zsh" include="included/optional-kubectl-configs-zsh.md" />}}
|
||||
{{< /tabs >}}
|
||||
|
||||
### Instalar en pc `kubectl convert` enchufar
|
||||
|
||||
{{< include "included/kubectl-convert-overview.md" >}}
|
||||
|
||||
1. Descargue la última versión con el comando:
|
||||
|
||||
```bash
|
||||
curl -LO https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl-convert
|
||||
```
|
||||
|
||||
1. Validar el binario (opcional)
|
||||
|
||||
Descargue el archivo de suma de comprobación kubectl-convert:
|
||||
|
||||
```bash
|
||||
curl -LO "https://dl.k8s.io/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl-convert.sha256"
|
||||
```
|
||||
|
||||
Valide el binario kubectl-convert con el archivo de suma de comprobación:
|
||||
|
||||
```bash
|
||||
echo "$(<kubectl-convert.sha256) kubectl-convert" | sha256sum --check
|
||||
```
|
||||
|
||||
Si es válido, la salida es:
|
||||
|
||||
```console
|
||||
kubectl-convert: OK
|
||||
```
|
||||
|
||||
Si la comprobación falla, `sha256` sale con un estado distinto de cero e imprime una salida similar a:
|
||||
|
||||
```bash
|
||||
kubectl-convert: FAILED
|
||||
sha256sum: WARNING: 1 computed checksum did NOT match
|
||||
```
|
||||
|
||||
{{< note >}}
|
||||
Descargue la misma versión del binario y la suma de comprobación.
|
||||
{{< /note >}}
|
||||
|
||||
1. Instalar en pc kubectl-convert
|
||||
|
||||
```bash
|
||||
sudo install -o root -g root -m 0755 kubectl-convert /usr/local/bin/kubectl-convert
|
||||
```
|
||||
|
||||
1. Verifique que el complemento se haya instalado correctamente
|
||||
|
||||
```shell
|
||||
kubectl convert --help
|
||||
```
|
||||
|
||||
Si no ve un error, significa que el complemento se instaló correctamente.
|
||||
|
||||
## {{% heading "whatsnext" %}}
|
||||
|
||||
{{< include "included/kubectl-whats-next.md" >}}
|
||||
@@ -0,0 +1,248 @@
|
||||
---
|
||||
reviewers:
|
||||
title: Instalar y configurar kubectl en macOS
|
||||
content_type: task
|
||||
weight: 10
|
||||
card:
|
||||
name: tasks
|
||||
weight: 20
|
||||
title: Instalar kubectl en macOS
|
||||
---
|
||||
|
||||
## {{% heading "prerequisites" %}}
|
||||
|
||||
Debes usar una versión de kubectl que esté dentro de una diferencia de versión menor de tu clúster. Por ejemplo, un v{{< skew latestVersion >}} La cliente puede comunicarse con v{{< skew prevMinorVersion >}}, v{{< skew latestVersion >}}, and v{{< skew nextMinorVersion >}} aviones de control.
|
||||
El uso de la última versión de kubectl ayuda a evitar problemas imprevistos.
|
||||
|
||||
## Instalar kubectl en macOS
|
||||
|
||||
Existen los siguientes métodos para instalar kubectl en macOS:
|
||||
|
||||
- [Instalar kubectl binary con curl en macOS](#install-kubectl-binary-with-curl-on-macos)
|
||||
- [Instalar con Homebrew en macOS](#install-with-homebrew-on-macos)
|
||||
- [Instalar con Macports en macOS](#install-with-macports-on-macos)
|
||||
|
||||
### Instalar kubectl binary con curl en macOS
|
||||
|
||||
1. Descargue la última versión:
|
||||
|
||||
{{< tabs name="download_binary_macos" >}}
|
||||
{{< tab name="Intel" codelang="bash" >}}
|
||||
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl"
|
||||
{{< /tab >}}
|
||||
{{< tab name="Apple Silicon" codelang="bash" >}}
|
||||
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl"
|
||||
{{< /tab >}}
|
||||
{{< /tabs >}}
|
||||
|
||||
{{< note >}}
|
||||
Para descargar una versión específica, reemplace el `$(curl -L -s https://dl.k8s.io/release/stable.txt)` parte del comando con la versión específica.
|
||||
|
||||
Por ejemplo, para descargar la versión {{< param "fullversion" >}} en Intel macOS, escriba:
|
||||
|
||||
```bash
|
||||
curl -LO "https://dl.k8s.io/release/{{< param "fullversion" >}}/bin/darwin/amd64/kubectl"
|
||||
```
|
||||
|
||||
Y para macOS en Apple Silicon, escriba:
|
||||
|
||||
```bash
|
||||
curl -LO "https://dl.k8s.io/release/{{< param "fullversion" >}}/bin/darwin/arm64/kubectl"
|
||||
```
|
||||
|
||||
{{< /note >}}
|
||||
|
||||
1. Validar el binario (opcional)
|
||||
|
||||
Descargue el archivo de suma de comprobación de kubectl:
|
||||
|
||||
{{< tabs name="download_checksum_macos" >}}
|
||||
{{< tab name="Intel" codelang="bash" >}}
|
||||
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl.sha256"
|
||||
{{< /tab >}}
|
||||
{{< tab name="Apple Silicon" codelang="bash" >}}
|
||||
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl.sha256"
|
||||
{{< /tab >}}
|
||||
{{< /tabs >}}
|
||||
|
||||
Valide el binario kubectl con el archivo de suma de comprobación:
|
||||
|
||||
```bash
|
||||
echo "$(<kubectl.sha256) kubectl" | shasum -a 256 --check
|
||||
```
|
||||
|
||||
Si es válido, la salida es:
|
||||
|
||||
```console
|
||||
kubectl: OK
|
||||
```
|
||||
|
||||
Si la verificación falla, `shasum` sale con un estado distinto de cero e imprime una salida similar a:
|
||||
|
||||
```bash
|
||||
kubectl: FAILED
|
||||
shasum: WARNING: 1 computed checksum did NOT match
|
||||
```
|
||||
|
||||
{{< note >}}
|
||||
Descargue la misma versión del binario y la suma de comprobación.
|
||||
{{< /note >}}
|
||||
|
||||
1. Hacer ejecutable el binario de kubectl.
|
||||
|
||||
```bash
|
||||
chmod +x ./kubectl
|
||||
```
|
||||
|
||||
1. Mueva el binario kubectl a una ubicación de archivo en su sistema `PATH`.
|
||||
|
||||
```bash
|
||||
sudo mv ./kubectl /usr/local/bin/kubectl
|
||||
sudo chown root: /usr/local/bin/kubectl
|
||||
```
|
||||
|
||||
{{< note >}}
|
||||
Cerciorarse `/usr/local/bin` está en su variable de entorno PATH.
|
||||
{{< /note >}}
|
||||
|
||||
1. Pruebe para asegurarse de que la versión que instaló esté actualizada:
|
||||
|
||||
```bash
|
||||
kubectl version --client
|
||||
```
|
||||
|
||||
### Instalar con Homebrew en macOS
|
||||
|
||||
Si está en macOS y usa [Homebrew](https://brew.sh/) administrador de paquetes, puede instalar kubectl con Homebrew.
|
||||
|
||||
1. Ejecute el comando de instalación:
|
||||
|
||||
```bash
|
||||
brew install kubectl
|
||||
```
|
||||
|
||||
or
|
||||
|
||||
```bash
|
||||
brew install kubernetes-cli
|
||||
```
|
||||
|
||||
1. Pruebe para asegurarse de que la versión que instaló esté actualizada:
|
||||
|
||||
```bash
|
||||
kubectl version --client
|
||||
```
|
||||
|
||||
### Instalar con Macports en macOS
|
||||
|
||||
Si está en macOS y usa [Macports](https://macports.org/) administrador de paquetes, puede instalar kubectl con Macports.
|
||||
|
||||
1. Ejecute el comando de instalación:
|
||||
|
||||
```bash
|
||||
sudo port selfupdate
|
||||
sudo port install kubectl
|
||||
```
|
||||
|
||||
1. Pruebe para asegurarse de que la versión que instaló esté actualizada:
|
||||
|
||||
```bash
|
||||
kubectl version --client
|
||||
```
|
||||
|
||||
## Verificar la configuración de kubectl
|
||||
|
||||
{{< include "included/verify-kubectl.md" >}}
|
||||
|
||||
## Complementos y configuraciones opcionales de kubectl
|
||||
|
||||
### Habilitar el autocompletado de shell
|
||||
|
||||
kubectl proporciona soporte de autocompletado para Bash y Zsh, lo que puede ahorrarle mucho escribir.
|
||||
|
||||
A continuación, se muestran los procedimientos para configurar el autocompletado para Bash y Zsh.
|
||||
|
||||
{{< tabs name="kubectl_autocompletion" >}}
|
||||
{{< tab name="Bash" include="included/optional-kubectl-configs-bash-mac.md" />}}
|
||||
{{< tab name="Zsh" include="included/optional-kubectl-configs-zsh.md" />}}
|
||||
{{< /tabs >}}
|
||||
|
||||
### Instalar el complemento `kubectl convert`
|
||||
|
||||
{{< include "included/kubectl-convert-overview.md" >}}
|
||||
|
||||
1. Descargue la última versión con el comando:
|
||||
|
||||
{{< tabs name="download_convert_binary_macos" >}}
|
||||
{{< tab name="Intel" codelang="bash" >}}
|
||||
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl-convert"
|
||||
{{< /tab >}}
|
||||
{{< tab name="Apple Silicon" codelang="bash" >}}
|
||||
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl-convert"
|
||||
{{< /tab >}}
|
||||
{{< /tabs >}}
|
||||
|
||||
1. Validar el binario (opcional)
|
||||
|
||||
Descargue el archivo de suma de comprobación de kubectl:
|
||||
|
||||
{{< tabs name="download_convert_checksum_macos" >}}
|
||||
{{< tab name="Intel" codelang="bash" >}}
|
||||
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl-convert.sha256"
|
||||
{{< /tab >}}
|
||||
{{< tab name="Apple Silicon" codelang="bash" >}}
|
||||
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl-convert.sha256"
|
||||
{{< /tab >}}
|
||||
{{< /tabs >}}
|
||||
|
||||
Valide el binario kubectl-convert con el archivo de suma de comprobación:
|
||||
|
||||
```bash
|
||||
echo "$(<kubectl-convert.sha256) kubectl-convert" | shasum -a 256 --check
|
||||
```
|
||||
|
||||
Si es válido, la salida es:
|
||||
|
||||
```console
|
||||
kubectl-convert: OK
|
||||
```
|
||||
|
||||
Si la verificación falla, `shasum` sale con un estado distinto de cero e imprime una salida similar a:
|
||||
|
||||
```bash
|
||||
kubectl-convert: FAILED
|
||||
shasum: WARNING: 1 computed checksum did NOT match
|
||||
```
|
||||
|
||||
{{< note >}}
|
||||
Descargue la misma versión del binario y la suma de comprobación.
|
||||
{{< /note >}}
|
||||
|
||||
1. Hacer ejecutable kubectl-convert binary
|
||||
|
||||
```bash
|
||||
chmod +x ./kubectl-convert
|
||||
```
|
||||
|
||||
1. Mueva el binario kubectl-convert a una ubicación de archivo en su sistema`PATH`.
|
||||
|
||||
```bash
|
||||
sudo mv ./kubectl-convert /usr/local/bin/kubectl-convert
|
||||
sudo chown root: /usr/local/bin/kubectl-convert
|
||||
```
|
||||
|
||||
{{< note >}}
|
||||
Cerciorarse `/usr/local/bin` está en tu PATH Variable ambiental.
|
||||
{{< /note >}}
|
||||
|
||||
1. Verifique que el complemento se haya instalado correctamente
|
||||
|
||||
```shell
|
||||
kubectl convert --help
|
||||
```
|
||||
|
||||
Si no ve un error, significa que el complemento se instaló correctamente.
|
||||
|
||||
## {{% heading "whatsnext" %}}
|
||||
|
||||
{{< include "included/kubectl-whats-next.md" >}}
|
||||
@@ -0,0 +1,190 @@
|
||||
---
|
||||
reviewers:
|
||||
title: Instalar y configurar kubectl en Windows
|
||||
content_type: task
|
||||
weight: 10
|
||||
card:
|
||||
name: tasks
|
||||
weight: 20
|
||||
title: Instalar kubectl en Windows
|
||||
---
|
||||
|
||||
## {{% heading "prerequisites" %}}
|
||||
|
||||
Debes usar una versión de kubectl que esté dentro de una diferencia de versión menor de tu clúster. Por ejemplo, un v{{< skew latestVersion >}} La cliente puede comunicarse con v{{< skew prevMinorVersion >}}, v{{< skew latestVersion >}}, y v{{< skew nextMinorVersion >}} aviones de control.
|
||||
|
||||
El uso de la última versión de kubectl ayuda a evitar problemas imprevistos.
|
||||
|
||||
## Instalar kubectl en Windows
|
||||
|
||||
Existen los siguientes métodos para instalar kubectl en Windows:
|
||||
|
||||
- [Instalar kubectl binary con curl en Windows](#install-kubectl-binary-with-curl-on-windows)
|
||||
- [Instalar en Windows usando Chocolatey o Scoop](#install-on-windows-using-chocolatey-or-scoop)
|
||||
|
||||
|
||||
### Instalar kubectl binary con curl en Windows
|
||||
|
||||
1. Descarga la [última versión {{< param "fullversion" >}}](https://dl.k8s.io/release/{{< param "fullversion" >}}/bin/windows/amd64/kubectl.exe).
|
||||
|
||||
O si tiene `curl` instalado, use este comando:
|
||||
|
||||
```powershell
|
||||
curl -LO https://dl.k8s.io/release/{{< param "fullversion" >}}/bin/windows/amd64/kubectl.exe
|
||||
```
|
||||
|
||||
{{< note >}}
|
||||
Para conocer la última versión estable (por ejemplo, para secuencias de comandos), eche un vistazo a [https://dl.k8s.io/release/stable.txt](https://dl.k8s.io/release/stable.txt).
|
||||
{{< /note >}}
|
||||
|
||||
1. Validar el binario (opcional)
|
||||
|
||||
Descargue el archivo de suma de comprobación de kubectl:
|
||||
|
||||
```powershell
|
||||
curl -LO https://dl.k8s.io/{{< param "fullversion" >}}/bin/windows/amd64/kubectl.exe.sha256
|
||||
```
|
||||
|
||||
Valide el binario kubectl con el archivo de suma de comprobación:
|
||||
|
||||
- Usando el símbolo del sistema para comparar manualmente la salida de `CertUtil` con el archivo de suma de comprobación descargado:
|
||||
|
||||
```cmd
|
||||
CertUtil -hashfile kubectl.exe SHA256
|
||||
type kubectl.exe.sha256
|
||||
```
|
||||
|
||||
- Usando PowerShell para automatizar la verificación usando el `-eq` Operadora para obtener una `True` o `False` resultado:
|
||||
|
||||
```powershell
|
||||
$($(CertUtil -hashfile .\kubectl.exe SHA256)[1] -replace " ", "") -eq $(type .\kubectl.exe.sha256)
|
||||
```
|
||||
|
||||
1. Agregue el binario a su `PATH`.
|
||||
|
||||
1. Prueba para asegurar la versión de`kubectl` Es la misma que descargada:
|
||||
|
||||
```cmd
|
||||
kubectl version --client
|
||||
```
|
||||
|
||||
{{< note >}}
|
||||
[Docker Desktop para Windows](https://docs.docker.com/docker-for-windows/#kubernetes) agrega su propia versión de `kubectl` a` PATH`.
|
||||
Si ha instalado Docker Desktop antes, es posible que deba colocar su `PATH` entrada antes de la agregada por el instalador de Docker Desktop o elimine el `kubectl`.
|
||||
{{< /note >}}
|
||||
|
||||
### Instalar en Windows usando Chocolatey o Scoop
|
||||
|
||||
1. Para instalar kubectl en Windows, puede usar [Chocolatey](https://chocolatey.org)
|
||||
administrador de paquetes o [Scoop](https://scoop.sh) instalador de línea de comandos.
|
||||
|
||||
{{< tabs name="kubectl_win_install" >}}
|
||||
{{% tab name="choco" %}}
|
||||
```powershell
|
||||
choco install kubernetes-cli
|
||||
```
|
||||
{{% /tab %}}
|
||||
{{% tab name="scoop" %}}
|
||||
```powershell
|
||||
scoop install kubectl
|
||||
```
|
||||
{{% /tab %}}
|
||||
{{< /tabs >}}
|
||||
|
||||
|
||||
1. Pruebe para asegurarse de que la versión que instaló esté actualizada:
|
||||
|
||||
```powershell
|
||||
kubectl version --client
|
||||
```
|
||||
|
||||
1. Navegue a su directorio de inicio:
|
||||
|
||||
```powershell
|
||||
# Si estas usando cmd.exe, correr: cd %USERPROFILE%
|
||||
cd ~
|
||||
```
|
||||
|
||||
1. Cree el directorio `.kube`:
|
||||
|
||||
```powershell
|
||||
mkdir .kube
|
||||
```
|
||||
|
||||
1. Cambie al directorio `.kube` que acaba de crear:
|
||||
|
||||
```powershell
|
||||
cd .kube
|
||||
```
|
||||
|
||||
1. Configure kubectl para usar un clúster de Kubernetes remoto:
|
||||
|
||||
```powershell
|
||||
New-Item config -type file
|
||||
```
|
||||
|
||||
{{< note >}}
|
||||
Edite el archivo de configuración con un editor de texto de su elección, como el Bloc de notas.
|
||||
{{< /note >}}
|
||||
|
||||
## Verificar la configuración de kubectl
|
||||
|
||||
{{< include "included/verify-kubectl.md" >}}
|
||||
|
||||
## Complementos y configuraciones opcionales de kubectl
|
||||
|
||||
### Habilitar el autocompletado de shell
|
||||
|
||||
kubectl proporciona soporte de autocompletado para Bash y Zsh, lo que puede ahorrarle mucho escribir.
|
||||
|
||||
A continuación se muestran los procedimientos para configurar el autocompletado para Zsh, si lo está ejecutando en Windows.
|
||||
|
||||
{{< include "included/optional-kubectl-configs-zsh.md" >}}
|
||||
|
||||
### Install `kubectl convert` plugin
|
||||
|
||||
{{< include "included/kubectl-convert-overview.md" >}}
|
||||
|
||||
1. Descargue la última versión con el comando:
|
||||
|
||||
```powershell
|
||||
curl -LO https://dl.k8s.io/release/{{< param "fullversion" >}}/bin/windows/amd64/kubectl-convert.exe
|
||||
```
|
||||
|
||||
1. Validar el binario (opcional)
|
||||
|
||||
Descargue el archivo de suma de comprobación kubectl-convert:
|
||||
|
||||
```powershell
|
||||
curl -LO https://dl.k8s.io/{{< param "fullversion" >}}/bin/windows/amd64/kubectl-convert.exe.sha256
|
||||
```
|
||||
|
||||
Valide el binario kubectl-convert con el archivo de suma de comprobación:
|
||||
|
||||
- Usando el símbolo del sistema para comparar manualmente la salida de `CertUtil` con el archivo de suma de comprobación descargado:
|
||||
|
||||
```cmd
|
||||
CertUtil -hashfile kubectl-convert.exe SHA256
|
||||
type kubectl-convert.exe.sha256
|
||||
```
|
||||
|
||||
- Usando PowerShell para automatizar la verificación usando el `-eq`
|
||||
Operadora para obtener una `True` or `False` resultado:
|
||||
|
||||
```powershell
|
||||
$($(CertUtil -hashfile .\kubectl-convert.exe SHA256)[1] -replace " ", "") -eq $(type .\kubectl-convert.exe.sha256)
|
||||
```
|
||||
|
||||
1. Agregue el binario a su`PATH`.
|
||||
|
||||
1. Verifique que el complemento se haya instalado correctamente
|
||||
|
||||
```shell
|
||||
kubectl convert --help
|
||||
```
|
||||
|
||||
Si no ve un error, significa que el complemento se instaló correctamente.
|
||||
|
||||
## {{% heading "whatsnext" %}}
|
||||
|
||||
{{< include "included/kubectl-whats-next.md" >}}
|
||||
@@ -0,0 +1,10 @@
|
||||
---
|
||||
title: "Descripción general de kubectl-convert"
|
||||
description: >-
|
||||
Un complemento de kubectl que le permite convertir manifiestos de una versión
|
||||
de una API de Kubernetes a una versión diferente.
|
||||
headless: true
|
||||
---
|
||||
|
||||
Un complemento para la herramienta de línea de comandos de Kubernetes `kubectl`, que le permite convertir manifiestos entre diferentes versiones de API. Esto puede ser particularmente útil para migrar manifiestos a una versión de API no obsoleta con la versión más reciente de Kubernetes.
|
||||
Para obtener más información, visite [migrar a APIs no obsoletas](/docs/reference/using-api/deprecation-guide/#migrate-to-non-deprecated-apis)
|
||||
@@ -0,0 +1,12 @@
|
||||
---
|
||||
title: "¿Que sigue?"
|
||||
description: "¿Qué sigue después de instalar kubectl."
|
||||
headless: true
|
||||
---
|
||||
|
||||
* [Instalar Minikube](https://minikube.sigs.k8s.io/docs/start/)
|
||||
* Consulte las [guías de introducción](/docs/setup/) para obtener más información sobre la creación de clústeres.
|
||||
* [Aprenda a iniciar y exponer su aplicación.](/docs/tasks/access-application-cluster/service-access-application-cluster/)
|
||||
* Si necesita acceso a un clúster que no creó, consulte la guia de
|
||||
[Compartir el acceso al clúster](/docs/tasks/access-application-cluster/configure-access-multiple-clusters/).
|
||||
* Lea los [documentos de referencia de kubectl](/docs/reference/kubectl/kubectl/)
|
||||
@@ -0,0 +1,54 @@
|
||||
---
|
||||
title: "Autocompletar bash en Linux"
|
||||
description: "Alguna configuración opcional para la finalización automática de bash en Linux."
|
||||
headless: true
|
||||
---
|
||||
|
||||
### Introducción
|
||||
|
||||
El script de finalización de kubectl para Bash se puede generar con el comando `kubectl completion bash`. Obtener el script de finalización en su shell habilita el autocompletado de kubectl.
|
||||
|
||||
Sin embargo, el guión de finalización depende de [**bash-completion**](https://github.com/scop/bash-completion), lo que significa que primero debe instalar este software (puedes probar si tienes bash-completion ya instalado ejecutando `type _init_completion`).
|
||||
|
||||
### Instalar bash-complete
|
||||
|
||||
La finalización de bash es proporcionado por muchos administradores de paquetes (ver [aquí](https://github.com/scop/bash-completion#installation)). Puedes instalarlo con `apt-get install bash-completion` o `yum install bash-completion`, etc.
|
||||
|
||||
Los comandos anteriores crean `/usr/share/bash-completion/bash_completion`, que es el guión principal de bash-complete. Dependiendo de su administrador de paquetes, debe obtener manualmente este archivo en su `~/.bashrc` expediente.
|
||||
|
||||
Para averiguarlo, recargue su shell y ejecute `type _init_completion`. Si el comando tiene éxito, ya está configurado; de lo contrario, agregue lo siguiente a su archivo `~/.bashrc`:
|
||||
|
||||
```bash
|
||||
source /usr/share/bash-completion/bash_completion
|
||||
```
|
||||
|
||||
Vuelva a cargar su shell y verifique que la finalización de bash esté correctamente instalada escribiendo `type _init_completion`.
|
||||
|
||||
### Habilitar el autocompletado de kubectl
|
||||
|
||||
Ahora debe asegurarse de que el script de finalización de kubectl se obtenga en todas sus sesiones de shell. Hay dos formas de hacer esto:
|
||||
|
||||
- Obtenga el script de finalización en su `~/.bashrc` expediente:
|
||||
|
||||
```bash
|
||||
echo 'source <(kubectl completion bash)' >>~/.bashrc
|
||||
```
|
||||
|
||||
- Agregue el guión de finalización al `/etc/bash_completion.d` directorio:
|
||||
|
||||
```bash
|
||||
kubectl completion bash >/etc/bash_completion.d/kubectl
|
||||
```
|
||||
|
||||
Si tiene un alias para kubectl, puede extender la finalización del shell para trabajar con ese alias:
|
||||
|
||||
```bash
|
||||
echo 'alias k=kubectl' >>~/.bashrc
|
||||
echo 'complete -F __start_kubectl k' >>~/.bashrc
|
||||
```
|
||||
|
||||
{{< note >}}
|
||||
fuentes de bash-complete todos los guiones `/etc/bash_completion.d`.
|
||||
{{< /note >}}
|
||||
|
||||
Ambos enfoques son equivalentes. Después de recargar su shell, el autocompletado de kubectl debería estar funcionando.
|
||||
@@ -0,0 +1,88 @@
|
||||
---
|
||||
title: "Autocompletar bash en macOS"
|
||||
description: "Alguna configuración opcional para la finalización automática de bash en macOS."
|
||||
headless: true
|
||||
---
|
||||
|
||||
### Introducción
|
||||
|
||||
El script de finalización de kubectl para Bash se puede generar con `kubectl completion bash`. Obtener este script en su shell permite la finalización de kubectl.
|
||||
|
||||
Sin embargo, el script de finalización de kubectl depende de [**finalización de bash**](https://github.com/scop/bash-completion) que, por lo tanto, debe instalar previamente.
|
||||
|
||||
{{< warning>}}
|
||||
Hay dos versiones de bash-complete, v1 y v2. V1 es para Bash 3.2 (
|
||||
que es el predeterminado en macOS), y v2 es para Bash 4.1+. El script de finalización de kubectl **no funciona** correctamente con bash-complete v1 y Bash 3.2. Requiere **bash-complete v2** y **Bash 4.1+**. Por lo tanto, para poder usar correctamente la finalización de kubectl en macOS, debe instalar y usar Bash 4.1+ ([*instrucciones*](https://itnext.io/upgrading-bash-on-macos-7138bd1066ba)). Las siguientes instrucciones asumen que usa Bash 4.1+ (es decir, cualquier versión de Bash de 4.1 o posterior).
|
||||
{{< /warning >}}
|
||||
|
||||
### Actualizar Bash
|
||||
|
||||
Las instrucciones aquí asumen que usa Bash 4.1+. Puede verificar la versión de su Bash ejecutando:
|
||||
|
||||
```bash
|
||||
echo $BASH_VERSION
|
||||
```
|
||||
Si es demasiado antiguo, puede instalarlo / actualizarlo usando Homebrew:
|
||||
|
||||
```bash
|
||||
brew install bash
|
||||
```
|
||||
Vuelva a cargar su shell y verifique que se esté utilizando la versión deseada:
|
||||
|
||||
```bash
|
||||
echo $BASH_VERSION $SHELL
|
||||
```
|
||||
|
||||
Homebrew generalmente lo instala en `/usr/local/bin/bash`.
|
||||
|
||||
### Instalar bash-complete
|
||||
|
||||
{{< note >}}
|
||||
Como se mencionó, estas instrucciones asumen que usa Bash 4.1+, lo que significa que instalará bash-completacion v2 (a diferencia de Bash 3.2 y bash-deployment v1, en cuyo caso la finalización de kubectl no funcionará).
|
||||
{{< /note >}}
|
||||
|
||||
Puede probar si ya tiene instalado bash-complete v2 con `type _init_completion`.Si no es así, puede instalarlo con Homebrew:
|
||||
|
||||
```bash
|
||||
brew install bash-completion@2
|
||||
```
|
||||
|
||||
Como se indica en el resultado de este comando, agregue lo siguiente a su archivo `~ / .bash_profile`:
|
||||
|
||||
```bash
|
||||
export BASH_COMPLETION_COMPAT_DIR="/usr/local/etc/bash_completion.d"
|
||||
[[ -r "/usr/local/etc/profile.d/bash_completion.sh" ]] && . "/usr/local/etc/profile.d/bash_completion.sh"
|
||||
```
|
||||
|
||||
Vuelva a cargar su shell y verifique que bash-complete v2 esté instalado correctamente con`type _init_completion`.
|
||||
|
||||
### Habilitar el autocompletado de kubectl
|
||||
|
||||
Ahora debe asegurarse de que el script de finalización de kubectl se obtenga en todas sus sesiones de shell. Hay varias formas de lograrlo:
|
||||
|
||||
- Obtenga el script de finalización en su `~/.bash_profile` expediente:
|
||||
|
||||
```bash
|
||||
echo 'source <(kubectl completion bash)' >>~/.bash_profile
|
||||
```
|
||||
|
||||
- Agregue el guión de finalización al `/usr/local/etc/bash_completion.d` directorio:
|
||||
|
||||
```bash
|
||||
kubectl completion bash >/usr/local/etc/bash_completion.d/kubectl
|
||||
```
|
||||
|
||||
- Si tiene un alias para kubectl, puede extender la finalización del shell para trabajar con ese alias:
|
||||
|
||||
```bash
|
||||
echo 'alias k=kubectl' >>~/.bash_profile
|
||||
echo 'complete -F __start_kubectl k' >>~/.bash_profile
|
||||
```
|
||||
|
||||
- Si instaló kubectl con Homebrew (como se explica [aquí](/docs/tasks/tools/install-kubectl-macos/#install-with-homebrew-on-macos)), entonces el script de finalización de kubectl ya debería estar en `/usr/local/etc/bash_completion.d/kubectl`. En ese caso, no necesita hacer nada.
|
||||
|
||||
{{< note >}}
|
||||
La instalación de Homebrew de bash -mentation v2 genera todos los archivos en el `BASH_COMPLETION_COMPAT_DIR` directorio, es por eso que los dos últimos métodos funcionan.
|
||||
{{< /note >}}
|
||||
|
||||
En cualquier caso, después de recargar su shell, la finalización de kubectl debería estar funcionando.
|
||||
@@ -0,0 +1,29 @@
|
||||
---
|
||||
title: "Autocompletar zsh"
|
||||
description: "Alguna configuración opcional para la finalización automática de zsh."
|
||||
headless: true
|
||||
---
|
||||
|
||||
El script de finalización de kubectl para Zsh se puede generar con el comando `kubectl completion zsh`. Obtener el script de finalización en su shell habilita el autocompletado de kubectl.
|
||||
|
||||
Para hacerlo en todas sus sesiones de shell, agregue lo siguiente a su`~/.zshrc` expediente:
|
||||
|
||||
```zsh
|
||||
source <(kubectl completion zsh)
|
||||
```
|
||||
Si tiene un alias para kubectl, puede extender la finalización del shell para trabajar con ese alias:
|
||||
|
||||
```zsh
|
||||
echo 'alias k=kubectl' >>~/.zshrc
|
||||
echo 'compdef __start_kubectl k' >>~/.zshrc
|
||||
```
|
||||
|
||||
Después de recargar su shell, el autocompletado de kubectl debería estar funcionando.
|
||||
|
||||
Si recibe un error como `complete:13: command not found: compdef`,
|
||||
luego agregue lo siguiente al comienzo de su `~/.zshrc` expediente:
|
||||
|
||||
```zsh
|
||||
autoload -Uz compinit
|
||||
compinit
|
||||
```
|
||||
@@ -0,0 +1,31 @@
|
||||
---
|
||||
title: "verificar la instalación de kubectl"
|
||||
description: "Cómo verificar kubectl."
|
||||
headless: true
|
||||
---
|
||||
|
||||
Para que kubectl encuentre y acceda a un clúster de Kubernetes, necesita un
|
||||
[archivo kubeconfig](/docs/concepts/configuration/organize-cluster-access-kubeconfig/),que se crea automáticamente cuando creas un clúster usando
|
||||
[kube-up.sh](https://github.com/kubernetes/kubernetes/blob/master/cluster/kube-up.sh)
|
||||
o implementar con éxito un clúster de Minikube.
|
||||
De forma predeterminada, la configuración de kubectl se encuentra en `~/.kube/config`.
|
||||
|
||||
Verifique que kubectl esté configurado correctamente obteniendo el estado del clúster:
|
||||
|
||||
```shell
|
||||
kubectl cluster-info
|
||||
```
|
||||
Si ve una respuesta de URL, kubectl está configurado correctamente para acceder a su clúster.
|
||||
|
||||
Si ve un mensaje similar al siguiente, kubectl no está configurado correctamente o no puede conectarse a un clúster de Kubernetes.
|
||||
```
|
||||
La conexión al servidor <server-name:port> fue rechazada. ¿Especificó el host o puerto correcto?
|
||||
```
|
||||
|
||||
Por ejemplo, si tiene la intención de ejecutar un clúster de Kubernetes en su computadora portátil (localmente), primero necesitará instalar una herramienta como Minikube y luego volver a ejecutar los comandos indicados anteriormente.
|
||||
|
||||
Si kubectl cluster-info devuelve la respuesta de la URL pero no puede acceder a su clúster, para verificar si está configurado correctamente, use:
|
||||
|
||||
```shell
|
||||
kubectl cluster-info dump
|
||||
```
|
||||
Reference in New Issue
Block a user