andock-build

andock-build est un rôle Ansible qui vérifie le dernier commit de votre branche, exécute tous les hooks de construction pour inclure les dépendances, effectue des tests et envoie l’artéfact construit dans le dépôt d’artéfacts git.

Exigences

Pour construire vos applications avec Andock, vous aurez besoin de :

• Ansible sur votre machine de déploiement
• Outils de construction comme composer ou autre
• git sur les deux machines

Variables de rôle

vars:
  git_source_repository_path: [email protected]:andock/drupal-8-demo.git # Le dépôt source 
  git_target_repository_path: [email protected]:andock/drupal-8-demo-build.git # Le dépôt cible. Peut être le même que le dépôt source 
  build_path: ~/ansible # Le chemin où la construction a lieu
  branch: "master" # La branche source. La branche cible serait master-build
  hook_build_tasks: "hooks/build_tasks.yml" # Le chemin vers votre fichier de hook de tâches de construction

Installation

Andock est un rôle Ansible distribué globalement via Ansible Galaxy. Pour installer le rôle Andock, vous pouvez utiliser la commande suivante.

$ ansible-galaxy install andock.build

Mise à jour

Si vous souhaitez mettre à jour le rôle, vous devez passer le paramètre --force lors de l'installation. Veuillez vérifier la commande suivante :

$ ansible-galaxy install --force andock.build

Exemple de Playbook

Inclure un exemple d'utilisation de votre rôle (par exemple, avec des variables passées en paramètres) est toujours appréciable pour les utilisateurs :

- name: Déployer le dépôt vers le dépôt de construction
  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"

Gestion de .gitignore

Vous pouvez marquer des parties de vos fichiers .gitignore avec "BEGIN REMOVE ANDOCK" --- END REMOVE ANDOCK-CI. Andock supprimera ces blocs avant leur commit dans le dépôt cible.

    # Exemple de fichier .gitignore pour un projet composer drupal 8
    .idea
    
    #### BEGIN REMOVE ANDOCK-CI ###
    docroot/core
    docroot/modules/contrib
    docroot/themes/contrib
    docroot/profiles/contrib
    vendor
    #### END REMOVE ANDOCK-CI ###

hooks de construction sous .ansible/hooks/build.yml

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

Licence

GPL

Informations sur l'auteur

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