tasks/deploy/artefact.yml

+---
+# file: roles/drupal/tasks/deploy/artefact.yml
+
+- block:
+
+  - name: Ensure Repository Directory
+    file:
+      path: '{{ tempDeployRoot }}'
+      state: directory
+      owner: root
+      group: root
+      mode: u+rwX,g+rwX,o+rX
+      recurse: yes
+      follow: no
+
+  - name: Create .env file
+    template:
+      src: env.jinja2
+      dest: '{{ tempDeployRoot }}/.env'
+      owner: root
+      group: root
+    when: drupal.env is defined
+
+  tags:
+    - deploy

tasks/finalize/artefact.yml

+---
+# file: roles/drupal/tasks/finalize/artefact.yml
+
+- name: Move directories
+  command: mv /path/to/foo /path/to/bar
+  with_items:
+    - src: '{{ webRoot }}/files'
+      dest: '{{ tempDeployRoot }}'
+    - src: '{{ webRoot }}/settings'
+      dest: '{{ tempDeployRoot }}'
+    - src: '{{ webRoot }}/web/sites/default'
+      dest: '{{ tempDeployRoot }}/web/sites'
+    - src: '{{ webRoot }}'
+      dest: '{{ webRoot }}-old'
+    - src: '{{ tempDeployRoot }}'
+      dest: '{{ webRoot }}'

tasks/deploy/finalize_d6.yml → tasks/finalize/d6.yml

 ---
-# file: roles/drupal/tasks/deploy/finalize_d6.yml
+# file: roles/drupal/tasks/finalize/d6.yml
 
 - name: Set facts
   set_fact:

tasks/deploy/finalize_d7.yml → tasks/finalize/d7.yml

 ---
-# file: roles/drupal/tasks/deploy/finalize_d7.yml
+# file: roles/drupal/tasks/finalize/d7.yml
 
 - name: Set facts
   set_fact:

tasks/deploy/finalize_d8.yml → tasks/finalize/d8.yml

 ---
-# file: roles/drupal/tasks/deploy/finalize_d8.yml
+# file: roles/drupal/tasks/finalize/d8.yml
 
 - block:
 

tasks/install.yml

@@ -37,6 +37,10 @@
         filesRoot: '{{ drupalRoot }}/sites'
         settingsRoot: '{{ drupalRoot }}/sites'
       when: not drupal.files_outside_root|default(true)
+    - name: Set facts for artefact mode
+      set_fact:
+        tempDeployRoot: '{{ webRoot }}-{{ lookup("pipe","date +%Y-%m-%d-%H-%M-%S") }}'
+      when: installSource.mode|default("none") == 'artefact'
   tags:
     - always
 
@@ -58,6 +62,7 @@
     follow: no
   tags:
     - deploy
+  when: installSource.mode|default("none") == 'artefact'
 
 - name: Check Installation Requirement
   shell: ls {{ drupalRoot }}/index.php
@@ -95,6 +100,14 @@
   tags:
     - deploy
 
+- name: Copy Artefacts
+  copy:
+    src: '{{ DRUPAL_ARTEFACT_SRC }}/'
+    dest: '{{ (installSource.mode|default("none") == "artefact")|ternary(tempDeployRoot,webRoot) }}/'
+  when: DRUPAL_ARTEFACT_SRC is defined
+  tags:
+    - deploy
+
 - name: Ensure links
   file:
     src: '{{ webRoot }}{{ item.src }}'
@@ -254,17 +267,15 @@
     - deploy
   when: drush_version_main|default('8') == '9'
 
-- name: Include deploy finalize version
-  include_tasks: deploy/finalize_{{ drupal.version|default("d7") }}.yml
-  when: drupal_install_drupal
+- name: Include finalize mode
+  include_tasks: finalize/{{ installSource.mode|default("none") }}.yml
+  when: drupal_install_drupal and installSource.mode|default("none") == 'artefact'
   tags:
     - deploy
 
-- name: Copy Artefacts
-  copy:
-    src: '{{ DRUPAL_ARTEFACT_SRC }}/'
-    dest: '{{ webRoot }}/'
-  when: DRUPAL_ARTEFACT_SRC is defined
+- name: Include finalize version
+  include_tasks: finalize/{{ drupal.version|default("d7") }}.yml
+  when: drupal_install_drupal
   tags:
     - deploy
 

tasks/install/artefact.yml

+---
+# file: roles/drupal/tasks/install/artefact.yml
+
+- name: Set facts
+  set_fact:
+    dummy: yes

tasks/users/artefact.yml

+---
+# file: roles/drupal/tasks/users/artefact.yml
+
+- name: Set facts
+  set_fact:
+    dummy: yes