Cómo publicar un módulo o un theme en Drupal.org

En este pequeño tutorial, vamos a aprender a cómo publicar un módulo o un theme en Drupal.org. No voy a entrar mucho en profundidad pero si quiero mostraros tódos los pasos necesarios.

Requisitos previos

Es obvio que deberemos poseer una cuenta en Drupal.org y que nuestro rol deberá ser el de "Usuario Confirmado" (puedes obtener más información sobre el esto en: become-a-confirmed-user)

Una vez conseguido este rol, deberemos generar nuestras claves SSH para poder enviar nuestros archivos al repositorio de Drupal.

Para generar estas claves escribiremos en un terminal de git lo siguiente:

ssh-keygen

Por defecto, este comando generará nuestras claves en la carpeta c:\users\[usuario]\.ssh, dónde [usuario] será el que usemos para loguearnos en windows.

En esta carpeta deberemos abrir el archivo id_rsa.pub y copiar su contenido.

Obtener acceso a nuestro repositorio

Una vez hemos copiado nuestra clave pública, es el momento de dirigirnos a nuestro perfil en Drupal.org y entraremos en el menu SSH keys, dónde añadiremos nuestra clave generada en el paso anterior.

Configuración local de Git

Para poder conectarnos con nuestro repositorio de Drupal.org deberemos configurar nuestro nombre y correo electrónico en la configuración de git. 

Esto lo haremos lanzando estos dos comandos desde una terminal git:

git config --global user.name 'Oscar Novas Fajardo'
git config --global user.email 'hola@oscarnovas.com'

El nombre y correo que debemos usar lo podemos ver en nuestro perfil de Drupal.org en la sección de Git access.

Crear versiones y etiquetas

Drupal usa unas convenciones específicas para los nombres de versiones que puedes consultar en este enlace: Release naming conventions.

Para ejemplificar estas convenciones supongamos que estamos creando un módulo para Drupal 8 y que será nuestra primera versión... El nombre que deberemos darle a nuestra rama en git será 8.x-1.0 (usaremos 8.x-1.x-dev para nuestra versión de desarrollo).

En git usaremos la siguiente secuencia de comandos dentro de nuestro proyecto para generar una versión y su etiqueta:

git init
git checkout -b 8.x-1.0
git tag -a 8.x-1.0
git add .
git comit -m "Initial commit"

Conectarse al repositorio remoto en Drupal.org

Una vez hemos creado nuestro repositorio dentro de Drupal.org, nos será proporcionado un comando para conectarnos al mismo...

git remote add origin git@git.drupal.org:project/[nombre_proyecto].git

En este ejemplo sustituiremos [nombre_proyecto] por el nombre que nosotros hemos dado al mismo.

Una vez lanzado este comando, realizaremos el envío mediante del comando de git:

git push origin 8.x-1.0

y para enviar las etiquetas generadas...

git push --tags

Últimos pasos

Con los pasos previos ya tenemos subido nuestro código a Drupal.org, ahora simplemente deberemos indicar las diferentes "releases" que disponemos.