# Probar tu despliegue de R


## Requisitos previos

- Completa todas las secciones anteriores de esta guía, comenzando con [Contenedorizar una aplicación R](/guides/r/deploy/containerize/).
- [Activa Kubernetes](/desktop/use-desktop/kubernetes/#enable-kubernetes) en Docker Desktop.

## Descripción general

En esta sección, aprenderás a usar Docker Desktop para desplegar tu aplicación en un entorno Kubernetes con todas las funciones en tu máquina de desarrollo. Esto te permite probar y depurar tus cargas de trabajo en Kubernetes localmente antes de realizar el despliegue.

## Crear un archivo YAML de Kubernetes

En tu directorio `r-docker-dev`, crea un archivo llamado `docker-r-kubernetes.yaml`. Abre el archivo en un IDE o editor de texto y agrega el siguiente contenido. Reemplaza `DOCKER_USERNAME/REPO_NAME` con tu usuario de Docker y el nombre del repositorio que creaste en [Configurar CI/CD para tu aplicación R](/guides/r/deploy/configure-ci-cd/).

```yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: docker-r-demo
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      service: shiny
  template:
    metadata:
      labels:
        service: shiny
    spec:
      containers:
        - name: shiny-service
          image: DOCKER_USERNAME/REPO_NAME
          imagePullPolicy: Always
          env:
            - name: POSTGRES_PASSWORD
              value: mysecretpassword
---
apiVersion: v1
kind: Service
metadata:
  name: service-entrypoint
  namespace: default
spec:
  type: NodePort
  selector:
    service: shiny
  ports:
    - port: 3838
      targetPort: 3838
      nodePort: 30001
```

En este archivo YAML de Kubernetes, hay dos objetos, separados por `---`:

- Un Deployment (Despliegue), que describe un grupo escalable de pods idénticos. En este caso, obtendrás solo una réplica o copia de tu pod. Ese pod, que se describe en `template`, tiene un solo contenedor dentro. El contenedor se crea a partir de la imagen compilada por GitHub Actions en [Configurar CI/CD para tu aplicación R](/guides/r/deploy/configure-ci-cd/).
- Un servicio NodePort, que enrutará el tráfico desde el puerto 30001 en tu host al puerto 3838 dentro de los pods a los que se dirige, lo que te permite acceder a tu aplicación desde la red.

Para obtener más información sobre los objetos de Kubernetes, consulta la [documentación de Kubernetes](https://kubernetes.io/docs/home/).

## Desplegar y comprobar tu aplicación

1. En una terminal, navega a `r-docker-dev` y despliega tu aplicación en Kubernetes.

   ```console
   $ kubectl apply -f docker-r-kubernetes.yaml
   ```

   Deberías ver una salida similar a la siguiente, que indica que tus objetos de Kubernetes se crearon correctamente.

   ```text
   deployment.apps/docker-r-demo created
   service/service-entrypoint created
   ```

2. Asegúrate de que todo haya funcionado listando tus despliegues.

   ```console
   $ kubectl get deployments
   ```

   Tu despliegue debería aparecer de la siguiente manera:

   ```shell
   NAME                 READY   UP-TO-DATE   AVAILABLE   AGE
   docker-r-demo        1/1     1            1           15s
   ```

   Esto indica que todos los pods que solicitaste en tu YAML están listos y en ejecución. Realiza la misma comprobación para tus servicios.

   ```console
   $ kubectl get services
   ```

   Deberías obtener una salida como la siguiente.

   ```shell
   NAME                 TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)          AGE
   kubernetes           ClusterIP   10.96.0.1       <none>        443/TCP          23h
   service-entrypoint   NodePort    10.99.128.230   <none>        3838:30001/TCP   75s
   ```

   Además del servicio predeterminado `kubernetes`, puedes ver tu servicio `service-entrypoint`, que acepta tráfico en el puerto 30001/TCP.

3. In un navegador, visita la siguiente dirección. Ten en cuenta que en este ejemplo no se desplegó una base de datos.

   ```console
   http://localhost:30001/
   ```

4. Ejecuta el siguiente comando para eliminar tu aplicación.

   ```console
   $ kubectl delete -f docker-r-kubernetes.yaml
   ```

## Resumen

En esta sección, aprendiste a usar Docker Desktop para desplegar tu aplicación en un entorno Kubernetes con todas las funciones en tu máquina de desarrollo.

Información relacionada:

- [Documentación de Kubernetes](https://kubernetes.io/docs/home/)
- [Desplegar en Kubernetes con Docker Desktop](/desktop/use-desktop/kubernetes/)
- [Descripción general del modo Swarm](/engine/swarm/)

