Skip to content
Snippets Groups Projects
Commit bce633cb authored by fejao's avatar fejao
Browse files

Updated the README.md file

parent b36b7f49
Branches
No related tags found
No related merge requests found
Pipeline #38340 passed
Pipeline: c3infodesk-deployment

#38341

    ...@@ -33,43 +33,34 @@ You need to set some configuration for this to work ...@@ -33,43 +33,34 @@ You need to set some configuration for this to work
    ## Role Variables ## Role Variables
    Here are the variables setted: Here are the variables setted:
    - ### From: inventories/host_vars/<TARGET_NAME> - ### c3infodesk_deployment_paht_docker_folder
    Here are the variables that you should be changing for your own deployment. - This should be a **string** entry with the path of the folder where is located the docker folder from the setted beforehand cloned repository.
    - **c3infodesk_printer_debug_create_image_cups**: DEFAULT=<NOT_SETTED> - **DEFAULT**: *"Coding/c3infodesk-printer/docker"*
    - If you want to debug the output from creating the image for CUPS
    - **c3infodesk_printer_debug_create_image_app**: DEFAULT=<NOT_SETTED> - ### c3infodesk_deployment_docker_images_list
    - If you want to debug the output from creating the image for the APP - This should be a **list** entry with the the information of the images that should be builded/created from this role.
    - **c3infodesk_printer_debug_create_image_proxy**: DEFAULT=<NOT_SETTED> - This list include entries with the default keys:
    - If you want to debug the output from creating the image for the PROXY - **docker_file_path**
    - The path from the location of the **Dockerfile** for the image to be builded.
    - ### From: inventories/group_vars/<TARGET_GROUP> - **docker_image_name**
    Please don't cahnge the default values at this file. If you need to update them, use the **inventories/host_vars/<TARGET_NAME>** file. - The name of the image to be builded.
    - **c3infodesk_printer_folder_docker**: DEFAULT="Coding/c3infodesk-printer/docker" - **docker_image_tag**
    - The folder where the configuration from docker used for the system - The tag of the image to be builded.
    - **c3infodesk_printer_folder_docker_cups**: DEFAULT="Coding/c3infodesk-printer/docker/cups" - **DEFAULT**: The default values are seeted for the [c3InfoDesk-Printer](https://git.cccv.de/fejao/c3infodesk-printer) project.
    - The folder where the configuration from docker CUPS used for the system ```yaml
    - **c3infodesk_printer_folder_docker_app**: DEFAULT="Coding/c3infodesk-printer/docker/app" c3infodesk_deployment_docker_images_list:
    - The folder where the configuration from docker APP used for the system - docker_file_path: docker/cups/Dockerfile
    - **c3infodesk_printer_folder_docker_proxy**: DEFAULT="Coding/c3infodesk-printer/docker/proxy" docker_image_name: c3printing-cups
    - The folder where the configuration from docker PROXY used for the system docker_image_tag: latest
    - **c3infodesk_printer_docker_img_cups_name**: DEFAULT="c3printing-cups"
    - The name of the image to be set for the CUPS - docker_file_path: docker/app/Dockerfile
    - **c3infodesk_printer_docker_img_cups_tag**: DEFAULT="latest" docker_image_name: c3printing-app
    - The tag name/number to be setted for the CUPS image docker_image_tag: latest
    - **c3infodesk_printer_docker_img_app_name**: DEFAULT="c3printing-app"
    - The name of the image to be set for the APP - docker_file_path: docker/proxy/Dockerfile
    - **c3infodesk_printer_docker_img_app_tag**: DEFAULT="latest" docker_image_name: c3printing-proxy
    - The tag name/number to be setted for the APP image docker_image_tag: latest
    - **c3infodesk_printer_docker_img_proxy_name**: DEFAULT="c3printing-proxy" ```
    - The name of the image to be set for the PROXY
    - **c3infodesk_printer_docker_img_proxy_tag**: DEFAULT="latest"
    - The tag name/number to be setted for the PROXY image
    - ### From: roles/clone-repositories/defaults/main.yml
    Don't change the values at this file, if you need to change them, change it at the **inventories/host_vars/<TARGET_NAME>** file
    - **c3infodesk_printer_debug_create_image_cups**: DEFAULT=false
    - **c3infodesk_printer_debug_create_image_app**: DEFAULT=false
    - **c3infodesk_printer_debug_create_image_proxy**: DEFAULT=false
    ## Dependencies ## Dependencies
    ...@@ -117,8 +108,10 @@ You can test this locally using **DIND (docker in docker)** at your own computer ...@@ -117,8 +108,10 @@ You can test this locally using **DIND (docker in docker)** at your own computer
    - ### Testing requirements - ### Testing requirements
    You need docker installed at your system and the [ansible molecule](https://ansible.readthedocs.io/projects/molecule/installation/). You need docker installed at your system and the [ansible molecule](https://ansible.readthedocs.io/projects/molecule/installation/).
    You might have to set DIND at your system, for linux, you can create the file **/etc/docker/daemon.json** - #### Setting *DIND (docker in docker)*
    You might have to set *DIND (docker in docker)* at your system, for linux, you can create the file **/etc/docker/daemon.json**
    - ##### Enabling DIND at your system
    And add the content and restart docker. And add the content and restart docker.
    ```json ```json
    ...@@ -132,11 +125,17 @@ You can test this locally using **DIND (docker in docker)** at your own computer ...@@ -132,11 +125,17 @@ You can test this locally using **DIND (docker in docker)** at your own computer
    } }
    ``` ```
    - ### Using molecule - ### Using the molecule tests
    Just go to the root of the role **roles/dependencies** and run the command:
    - #### Configuring the *HOST_VAR_FILE_NAME* variable
    For using the molecule tests you should pass the **HOST_VAR_FILE_NAME** environment variable, or the default value for testing is: **example_printer.yml**
    For the values that can be used, you can lool at the files at the **inventories/host_vars** folder.
    - ##### Molecule test example
    Just go to the root of the role **roles/x3infodesk-deployment-role-dependencies** and run the command, here is an example for using the **HOST_VAR_FILE_NAME** as *example_buttons.yml*:
    ```bash ```bash
    molecule test HOST_VAR_FILE_NAME="example_buttons.yml" molecule test
    ``` ```
    ......
    0% Loading or .
    You are about to add 0 people to the discussion. Proceed with caution.
    Please register or to comment