andock-build

andock-build es un rol de Ansible que obtiene el último commit de tu rama, ejecuta todos los hooks de construcción para incluir dependencias, realiza pruebas y sube el artefacto construido al repositorio de artefactos de git.

Requisitos

Para construir tus aplicaciones con Andock, necesitarás:

• Ansible en tu máquina de despliegue
• Herramientas de construcción como composer u otra similar
• git en ambas máquinas

Variables del rol

vars:
  git_source_repository_path: [email protected]:andock/drupal-8-demo.git # El repositorio fuente 
  git_target_repository_path: [email protected]:andock/drupal-8-demo-build.git # El repositorio destino. Puede ser el mismo repositorio que el fuente 
  build_path: ~/ansible # La ruta donde se realiza la construcción
  branch: "master" # La rama fuente. La rama destino sería master-build
  hook_build_tasks: "hooks/build_tasks.yml" # La ruta a tu archivo de hook de build_tasks

Instalación

Andock es un rol de Ansible distribuido globalmente usando Ansible Galaxy. Para instalar el rol de Andock, puedes usar el siguiente comando.

$ ansible-galaxy install andock.build

Actualización

Si deseas actualizar el rol, necesitas pasar el parámetro --force al instalar. Por favor, revisa el siguiente comando:

$ ansible-galaxy install --force andock.build

Ejemplo de Playbook

Incluir un ejemplo de cómo usar tu rol (por ejemplo, con variables pasadas como parámetros) es útil para los usuarios:

- name: Desplegar repositorio en repositorio de construcción
  hosts: localhost
  
  roles:
    - role: build
      git_source_repository_path: [email protected]:andock/drupal-8-demo.git
      build_path: ~/ansible
      branch: "master"
      hook_build_tasks: "hooks/build_tasks.yml"

Manejo de .gitignore

Puedes marcar partes en tus archivos .gitignore con "BEGIN REMOVE ANDOCK" --- END REMOVE ANDOCK-CI. andock eliminará esos bloques antes de que sean comprometidos al repositorio de destino.

    #Ejemplo de archivo .gitignore para un proyecto de drupal 8 con composer
    .idea
    
    #### BEGIN REMOVE ANDOCK-CI ###
    docroot/core
    docroot/modules/contrib
    docroot/themes/contrib
    docroot/profiles/contrib
    vendor
    #### END REMOVE ANDOCK-CI ###

hooks de construcción bajo .ansible/hooks/build.yml

- name: composer install
  command: fin rc -T composer install
  args:
    chdir: "{{ build_path }}"

Licencia

GPL

Información del Autor

Christian Wiedemann (christian.wiedemann@key-tec.de)