# Configuración de Docker Build Cloud


Antes de que puedas comenzar a usar Docker Build Cloud, debes añadir el builder a
tu entorno local.

## Requisitos previos

Para comenzar con Docker Build Cloud, necesitas:

- Descargar e instalar Docker Desktop versión 4.26.0 o posterior.
- Crear un builder en la nube en el [Panel de control de Docker Build Cloud](https://app.docker.com/build/).
  - Al crear el builder, elige un nombre para este (por ejemplo, `default`).
    Utilizarás este nombre como `BUILDER_NAME` en los pasos de la CLI detallados a
    continuación.

### Utilizar Docker Build Cloud sin Docker Desktop

Para usar Docker Build Cloud sin Docker Desktop, debes descargar e instalar una
versión de Buildx que sea compatible con Docker Build Cloud (el controlador
`cloud`). Puedes encontrar binarios de Buildx compatibles en la página de
lanzamientos de [este repositorio](https://github.com/docker/buildx-desktop).

Si planeas compilar con Docker Build Cloud utilizando el comando `docker compose
build`, también necesitas una versión de Docker Compose que sea compatible con
Docker Build Cloud. Puedes encontrar binarios de Docker Compose compatibles en la
página de lanzamientos de [este repositorio](https://github.com/docker/compose-desktop).

## Pasos

Puedes añadir un builder en la nube utilizando la CLI con el comando `docker
buildx create`, o bien utilizando la interfaz gráfica (GUI) de configuración de
Docker Desktop.

**CLI**



1. Inicia sesión en tu cuenta de Docker.

   ```console
   $ docker login
   ```

2. Añade el endpoint del builder en la nube.

   ```console
   $ docker buildx create --driver cloud <ORG>/<BUILDER_NAME>
   ```

   Reemplaza `<ORG>` con el espacio de nombres (namespace) de tu organización de
   Docker Hub (o tu nombre de usuario si utilizas una cuenta personal), y
   `<BUILDER_NAME>` con el nombre que elegiste al crear el builder en el panel
   de control.

   Esto crea una instancia local del builder en la nube llamada
   `cloud-ORG-BUILDER_NAME`.

   > [!NOTE]
   >
   > Si tu organización es `acme` y nombraste a tu builder `default`, utiliza:
   >
   > ```console
   > $ docker buildx create --driver cloud acme/default
   > ```

**Docker Desktop**



1. Inicia sesión en tu cuenta de Docker utilizando el botón **Iniciar sesión**
   (Sign in) en Docker Desktop.

2. Abre la configuración de Docker Desktop y navega a la pestaña **Builders**.

3. En **Available builders**, selecciona **Connect to builder** (Conectarse al builder).



El builder tiene soporte nativo para las arquitecturas `linux/amd64` y
`linux/arm64`. Esto te proporciona un clúster de compilación de alto rendimiento
para compilar imágenes multiplataforma de forma nativa.

## Configuración del firewall

Para utilizar Docker Build Cloud detrás de un firewall, asegúrate de que este
permita el tráfico hacia las siguientes direcciones:

- 3.211.38.21
- https://auth.docker.io
- https://build-cloud.docker.com
- https://hub.docker.com

## Qué sigue

- Consulta [Compilar con Docker Build Cloud](/build-cloud/setup/usage/) para ver ejemplos de cómo
  utilizar Docker Build Cloud.
- Consulta [Uso de Docker Build Cloud en CI](/build-cloud/setup/ci/) para ver ejemplos de cómo
  utilizar Docker Build Cloud con sistemas de CI.