Archtrans - Local Dev env

Una vez que tenés todas las dependencies (Docker, Lando, Git) instaladas y configuradas (referisrse a Intro) podés clonarte el repo e instalar Drupal.

Sólo 6 pasitos para tener tu entorno de desarrollo local

Initial Build

1. Clonar el repositorio:

     git clone git@gitlab.com:archtrans/www.git
   

   Cuando se clone el repo, te va a generar un direcotrio www en donde lo hayas clonado. Por ejemplo: /tu/dir/local/archtrans/www

2. Crear un .env file en docroot dir (/tu/dir/local/archtrans/www/docroot)

     /tu/dir/local/archtrans/www $ cd docroot
     /tu/dir/local/archtrans/www/docroot $ touch .env
   

   Y editalo con tu editor de texto plano preferido (vim/nano/etc…) para agregar los siguientes contenidos:

   .env file

   MYSQL_USER=drupal8
   DRUPAL_MYSQL_HOST=database
   MYSQL_PASSWORD=drupal8
   MYSQL_DATABASE=drupal8
   PHP_IDE_CONFIG="serverName=appserver"
   IS_LOCAL=TRUE
   

   Si usás Linux podés simplemente correr cat > .env y pegar el contenido del archivo con SHFT+CTRL+V y luego CTRL+D para cerrar cat :)

   EXPLICACIÓN: El archivo .env tiene que estar dentro de /www/docroot es decir en el mismo nivel que RoboFile.php ya que va a ser utilizado por Robo para instalar Drupal con las credenciales de la DB que definimos en el .env

3. Inicializar lando

   lando start
   

   Si todo fue bien deberías ver un mensaje de éxito (?) y una lista de URLs:

   Tomá nota de las de appserver_nginx URLs esas son las direcciónes de tu sitio local.

   Screenshot

4. Instalar las dependencias con composer

   lando composer install
   

5. Instalar Drupal (estamos usando Robo para instalar Drupal y correr tareas de importación/exportación de configuración).

   lando robo local:install
   

   Cuando este comando termine de correr, deberías tener un sitio D8 listo con todas las configs importadas .

6. Finalmente, habilitá nuestro módulo custom de Default Content (amt_default_content) para crear un par de contenidos (bloques, usuarios, unidades documentales y Fondos documentales).

   lando drush en amt_default_content
   

   Habilitar este módulo no sólo crea contenido sino también usuarios, así que en este punto ya te podés loguear con tu usuario de Drupal (el mismo que usás para el sitio en el servidor). Si no te acordás tu contraseña podés:

   • Generar un “one-time” login link con el siguiente comando de drush: lando drush uli username Reemplazando username con tu nombre de usuario.
   • Utilizar el formulario de forgot password, que enviará un “one-time” login link al mail local. Podés acceder al mail local usando la url que lando genera para mailhog.

Acceder al sitio

Info

El sitio Drupal configurado como está en el servidor remoto y con contenido de prueba estará accesible en https://archtrans-demo.lndo.site

Si no podés acceder a esa URL y usas Linux, es problable que tengas que agregar el dominio a tu archivo de hosts /etc/hosts/ Otra opción es utilizar las otras URLs disponibles que genera Lando cuando Inicia y que se pueden volver a ver con lando info

Actualizar el sitio

Traerse el código último del repositorio

Pararse en el directorio donde está clonado el repo y correr:

git pull origin master

O en su defecto, usar git con entorno gráfico (GIT GUI).

1. Branch > Checkout > master (para asegurarte que te vas a traer los cambios de master que es nuestra rama “base”)

2. Remote > Fetch from > origin

Eso debería traerte los cambios míos que están en la rama master

Screenshot

Instalar dependencias con composer

lando composer install

Importar cambios de configuración.

lando robo local:update