docker_compose - add env_file option (#174)

* Initial commit

* Adding changelog and fixing docs

* Fixing integration tests

* Restricting minimum docker-compose versions for tests

* Applying initial review suggestions

tests/integration/targets/docker_compose/tasks/tests/options.yml

@@ -94,4 +94,84 @@
       vars:
         cname_1_name: "{{ pname + '_' + cname_1 + '_1' }}"
         cname_2_name: "{{ pname + '_' + cname_2 + '_1' }}"
-  when: docker_compose_version is version('1.28.0', '>=')
+  when: docker_compose_version is version('1.28.0', '>=')
+
+####################################################################
+## Env_file ########################################################
+####################################################################
+
+- block:
+    - name: Define service and files
+      set_fact:
+        compose_file: "{{ output_dir }}/docker-compose.yml"
+        env_file: "{{ output_dir }}/.env"
+        env_sleep_cmd: sleep 10m
+        new_env_file: "{{ output_dir }}/new.env"
+        new_env_sleep_cmd: sleep 20m
+        test_service: |
+          version: '2'
+          services:
+            {{ cname_1 }}:
+              image: "{{ docker_test_image_alpine }}"
+              command: '/bin/sh -c "${SLEEP_CMD}"'
+              stop_grace_period: 1s
+
+    - name: Define testcases
+      set_fact:
+        test_cases:
+          - test_name: Without env_file option
+          - test_name: With env_file option
+            env_file: "{{ new_env_file }}"
+
+    - name: Generate compose file
+      ansible.builtin.copy:
+        content: "{{ test_service }}"
+        dest: "{{ compose_file }}"
+
+    - name: Generate .env file
+      ansible.builtin.copy:
+        content: |
+          SLEEP_CMD="{{ env_sleep_cmd }}"
+        dest: "{{ env_file }}"
+
+    - name: Generate new.env file
+      ansible.builtin.copy:
+        content: |
+          SLEEP_CMD="{{ new_env_sleep_cmd }}"
+        dest: "{{ new_env_file }}"
+
+    - name: Env_file
+      docker_compose:
+        project_name: "{{ pname }}"
+        project_src: "{{ output_dir }}"
+        env_file: "{{ test_case.env_file | default(omit) }}"
+      register: env_file_outputs
+      loop: "{{ test_cases }}"
+      loop_control:
+        loop_var: test_case
+
+    - name: Cleanup
+      docker_compose:
+        project_name: "{{ pname }}"
+        state: absent
+        definition: "{{ test_service | from_yaml }}"
+
+    - assert:
+        that:
+          - "env_sleep_cmd is in (env_file_outputs.results[0].services[cname_1][cname_1_name].cmd | join(' '))"
+          - "new_env_sleep_cmd is in (env_file_outputs.results[1].services[cname_1][cname_1_name].cmd | join(' '))"
+      vars:
+        cname_1_name: "{{ pname + '_' + cname_1 + '_1' }}"
+        cname_2_name: "{{ pname + '_' + cname_2 + '_1' }}"
+
+    - name: Remove files
+      ansible.builtin.file:
+        path: "{{ file_path }}"
+        state: absent
+      loop_control:
+        loop_var: file_path
+      loop:
+        - "{{ compose_file }}"
+        - "{{ env_file }}"
+        - "{{ new_env_file }}"
+  when: docker_compose_version is version('1.25.0', '>=')