Conecte su cuenta de Bitbucket para que sus sitios se implementen desde un repositorio

Lo que la conexión hace por usted

Conectar Bitbucket le permite a un sitio desplegarse desde uno de sus repositorios de Bitbucket Cloud: realice un push a la rama y el sitio se actualizará.

Antes de empezar

Una cuenta de Bitbucket Cloud con acceso a los repositorios que desea desplegar.

1. Cree la clave en Bitbucket

Bitbucket ofrece dos tipos de credenciales, y ambas funcionan:

• Un token de acceso para un repositorio, proyecto o espacio de trabajo, creado desde la configuración propia de ese repositorio, proyecto o espacio de trabajo en Access tokens. Está vinculado a ese repositorio, proyecto o espacio de trabajo en lugar de a una persona. Concédale acceso de lectura a los repositorios.
• Un token de API en su cuenta de Atlassian. Seleccione su perfil y, a continuación, Account settings → Security → Create and manage API tokens → Create API token with scopes. Asígnele un nombre, establezca una fecha de caducidad, elija Bitbucket como aplicación y seleccione acceso de lectura a los repositorios. Bitbucket muestra el token una sola vez; cópielor en ese momento.

2. Conéctelo aquí

Abra Integrations en su panel de control y elija Connect an account. Seleccione Code hosting como grupo y Bitbucket como cuenta, complete API token —y, si creó un token en su cuenta de Atlassian en lugar de un token de acceso, también Account username— y pulse Connect account.

Probamos lo que pega antes de que se guarde nada. Una clave que no funciona nunca se almacena, y la respuesta indica qué falló en ella. Una clave que funciona se guarda cifrada en nuestro cofre de secretos (nunca en nuestra base de datos) y no se vuelve a mostrar jamás, ni siquiera a usted.

El nombre de usuario determina cómo enviamos el token, así que introdúzcalo únicamente para un token de cuenta. Se rechazará un token de acceso introducido con un nombre de usuario, o un token de cuenta sin él.

Qué ocurre después

• Un sitio puede desplegarse directamente desde un repositorio en esta cuenta: selecciónelo en la

conexión de repositorios del sitio, elija el repositorio y la rama, y un push realizará el despliegue.

• Cualquier otra rama puede obtener su propia vista previa, para que pueda comprobar un cambio antes de que llegue al

sitio en producción.

• Los hosts estáticos basados en Git, como Render y Azure Static Web Apps, utilizan esta conexión como origen del código del sitio.

Si no se conecta

Falta un repositorio. Un token de acceso solo llega al repositorio, proyecto o espacio de trabajo en el que se creó. Cree uno al nivel que abarque todos los repositorios que necesite.

Funcionó y luego se detuvo. Ambos tipos de token pueden caducar. Cree uno nuevo y conéctelo.

Indica que se rechazó la clave. Casi siempre se debe a una de estas tres cosas: se copió un espacio o un salto de línea junto con ella, la clave ha caducado, o la clave fue revocada o regenerada después de que la copiara. Cree una nueva y vuelva a pegarla.

Se conecta, pero algo falla más adelante. La clave se autentica pero carece de un permiso que la acción necesita. Cree una nueva clave con los permisos indicados anteriormente, desconecte la conexión antigua y conecte la nueva clave.

Desconexión

Abra Integrations, busque la cuenta y pulse Disconnect. Esto elimina la clave almacenada de inmediato. Todo lo que la estuviera utilizando se detendrá en su siguiente acción, y las pantallas que dependían de ella lo indicarán en lugar de fallar silenciosamente.

Desconectarla no deshace lo que ya se había hecho; los registros, despliegues o ajustes que hayamos cambiado en su cuenta se mantienen tal como están. Si cree que la clave en sí pudo haberse filtrado, revóquela también en el proveedor; la desconexión elimina nuestra copia, no la de ellos.