Usando Windows¶

Descargar terminal de GNU/Linux (WSL)¶

Para poder realizar este tutorial en Windows, primeramente debemos instalar un subsistema Linux en Windows. Este lo podemos encontrar en la Microsoft store. Ingresamos el nombre en el buscador de nuestro sistema operativo como se ve en la siguiente imagen

Una vez abierto Microsoft store, ingresamos wsl y nos saldran opciones de subsistemas Linux (distribuciones), se puede eligir el que prefiera el usuario

Para instalar una distribución pasamos el ratón por encima de la distribución deseada y en la esquina derecha aparecera un boton para instalarla. Al terminar la instalación podemos usar el buscador de Windows para encontrar nuestro wsl instalado

En este turorial usaremos la distribucion Ubuntu 20.04.6 TLS. Al abrirla, se les abrira una ventaja como la siguiente

Instalación y configuración¶

Con nuestra subsistema Linux wsl, procedemos a la instalación del cliente de kubernetes y su configuración.

Empezamos clonando el repositorio de github y entramos al directorio descargado

git clone https://github.com/CUDI-PIG/PIG.git
cd PIG-Resources

Ahora instalamos lo necesario corriendo el archivo wsl-setup.sh

chmod +x wsl-setup.sh
./wsl-setup.sh

Con el primer comando lo hacemos ejecutable.

Después, configuramos kubernetes ejecutando el archivo k8s-setup.sh

./k8s-setup.sh

Se nos pedirá una llave que nos dará el administrador del clúster, como se ve en la siguiente imagen

Por último, agregamos la siguiente ruta de la herramienta de línea de comandos para kubernetes, llamada krew, al archivo ~/.bashrc (configura nuestra shell de bash)

export PATH="${KREW_ROOT:-$HOME/.krew}/bin:$PATH"

Al agregar el PATH recargamos la shell

source ~/.bashrc

Para verificar que la instalación y configuración fue exitosa, usaremos el siguiente comando

kubectl get pods

Al ejecutar el comando se abrirá una página nueva en su navegador predeterminado como la siguiente

Donde deberá ingresar las credenciales de su cuenta en PIG proporcionadas por el administrador. Si al momento de correr un comando de kubernetes no abre la página de keycloak, como se ve en la image, entonces puede agregar la bandera --skip-open-browser al archivo k8s-setup.sh para que le imprima la URI donde se redirecciona la página de keycloak. Quedaría el comando de kubectl de la siguiente manera

kubectl config set-credentials oidc --exec-command=kubectl \
    --exec-api-version=client.authentication.k8s.io/v1beta1 \
    --exec-arg="oidc-login" \
    --exec-arg="get-token" \
    --exec-arg="--oidc-issuer-url=https://sso.lamod.unam.mx/auth/realms/cudi" \
    --exec-arg="--oidc-client-id=k8s" \
    --exec-arg="--oidc-client-secret=$client_secret" \
    --exec-arg="--skip-open-browser" \
    --kubeconfig=$KUBECONFIG

Debe correr el archivo de nuevo para que se apliquen los cambios.

Por predeterminado, se redirrecciona al localhost:8000 o localhost:18000. Si tiene ocupados esos puertos puede , en lugar de agregar la bandera --skip-open-browser, agregar la bandera --listen-address=127.0.0.1:puerto_deseado.

Si la conexión fue exitosa, en la terminal obtendrá el resultado del comando de kubernetes

Este comando nos muestra los pods actuales en PIG.

Cambiar constraseña de administrador (opcional)¶

Para cambiar la contraseña de su usuario con privilegios de administrador en wsl, podemos hacerlo desde la terminal Windows PowerShell, la cual ya esta instalada en Windows por predeterminado. En la terminal ejecutamos el comando

wsl -d Ubuntu-20.04 --user root

Por último, cambiamos la contraseña de nuestro usuario, en mi caso es victor, como se ve a continuación

Con esto ya podremos ejecutar los archivos usando esta nueva contraseña.