[Kogito-2195] Kogito examples with ansible automation

README.md

@@ -108,3 +108,8 @@ shows timers (intermediate and boundary) that allows to introduce delays in proc
 Every example has a directory named `operator` including the YAML files to deploy it using the Kogito Operator in an OpenShift cluster.
 Please refer to the [Kogito Documentation](https://docs.jboss.org/kogito/release/latest/html_single/#chap_kogito-deploying-on-openshift)
 of how to install the operator to your environment in order to try it there.
+
+## Deploying the Kogito example applications on OpenShift CRC using Ansible playbooks
+
+In the [Kogito Ansible folder](kogito-ansible/README.md) you find the documentation plus some external videos about how to
+setup Openshift locally (CRC) and deploy the kogito examples using ansible, with few commands

kogito-ansible/README.md

@@ -0,0 +1,90 @@
+# Openshift (CRC) Kogito ansible automation
+
+Tested on Fedora 31/32 and Ubuntu 19.10
+
+Ansible scripts to automate creation of CRC cluster and the deploy of one of the Kogito examples with just one command line.
+
+Ansible must be installed.
+
+
+### Create an account on cloud.redhat.com
+https://cloud.redhat.com/openshift/install and download or copy your Pull secret from the laptop installation https://cloud.redhat.com/openshift/install/crc/installer-provisioned
+
+
+## Fedora
+
+### Install LibVirt libs
+```sh
+sudo ansible-playbook ./playbook_libs.yaml
+```
+
+### Install CRC
+(If you haven't already installed)
+
+Download and copy CRC in the user's path (2GB),
+change the app_name (my-kafka-project) in the file if you want different name
+```sh
+ansible-playbook ./playbook_crc.yaml
+```
+
+### Install Kogito on CRC
+The create playbook will create from scratch the crc setup, the project namespace, then download  and install Kogito Operator and Kogito CLI.
+The name of the Project to create and the Pull secret will be asked in the beginning of the run.
+To use the default project name (my-kogito-project) just press enter.
+```sh
+ansible-playbook ./playbook_create.yaml
+```
+
+### Deploy Kogito Examples
+To deploy one of the kogito examples, enter the name of one of the example,
+at the end the browser show you the login page, the output of the deploy with the instructions to see
+the logs from cli will be on the ansible output.
+```sh
+ansible-playbook ./playbook_deploy.yaml
+```
+
+
+
+## Ubuntu
+
+### Install LibVirt libs
+```sh
+sudo ansible-playbook ./playbook_libs.yaml
+```
+
+### Install CRC
+(If you haven't already installed)
+Download and copy CRC in the user's path (2GB),
+change the app_name (my-kafka-project) in the file if you want different name
+```sh
+ansible-playbook ./playbook_crc.yaml
+```
+
+### Install Kogito on CRC
+
+The create playbook will create from scratch the crc setup, the project namespace, then download  and install Kogito Operator and Kogito CLI.
+The name of the Project to create and the Pull secret will be asked in the beginning of the run.
+To use the default project name (my-kogito-project) just press enter.
+```sh
+ansible-playbook ./playbook_create.yaml
+```
+### Deploy Kogito Examples
+To deploy one of the kogito examples, enter the name of one of the example,
+at the end the browser show you the login page, the output of the deploy with the instructions to see
+the logs from cli will be on the ansible output.
+```sh
+ansible-playbook ./playbook_deploy.yaml
+```
+
+
+
+## Videos
+Note: The CRC start spent 10 minute on a laptop, cut to few seconds in the video recording
+
+### Setup CRC
+Video Duration: 1:39 min.
+[![asciicast](https://asciinema.org/a/313700.png)](https://asciinema.org/a/313700)
+
+### Deploy Kpgotp Examples
+Video Duration 27:sec
+[![asciicast](https://asciinema.org/a/313703.png)](https://asciinema.org/a/313703)

kogito-ansible/playbook_crc.yaml

@@ -0,0 +1,56 @@
+---
+- name: Install CRC
+  hosts: localhost
+
+  vars:
+    crc_version: "1.10.0"
+    crc_url_file: "https://mirror.openshift.com/pub/openshift-v4/clients/crc/{{crc_version}}/crc-linux-amd64.tar.xz"
+    crc_tmp_dest: "/tmp/crc-linux-{{crc_version}}-amd64.tar.xz"
+    crc_package_name: "crc-linux-{{crc_version}}-amd64"
+
+  tasks:
+
+    - name: Create .local/bin/
+      file:
+        path: /home/{{ansible_user_id}}/.local/bin/
+        state: directory
+
+    - name: Check if crc exists in /home/{{ansible_user_id}}/.local/bin/
+      stat:
+        path: "/home/{{ ansible_user_id }}/.local/bin/crc"
+      register: stat_result
+
+    - name: Check if {{ crc_package_name }}/crc exists in /tmp/
+      stat:
+        path: "/tmp/{{ crc_package_name }}/crc"
+      register: stat_result
+
+    - name: "Download crc {{ crc_version }} ~2GB, this takes time and depends on your connection speed"
+      get_url:
+        url: "{{ crc_url_file }}"
+        dest: "{{ crc_tmp_dest }}"
+      when: stat_result.stat.exists == False
+
+    - name: Extract {{ crc_package_name }}.tar.xz into tmp
+      unarchive:
+        src: "{{ crc_tmp_dest }}"
+        dest: /tmp
+      when: stat_result.stat.exists == False
+
+    - name: Check if {{ crc_package_name }}/crc exists in /tmp/
+      stat:
+        path: "/tmp/{{ crc_package_name }}/crc"
+      register: stat_result
+
+    - name: Check if crc exists in /home/{{ansible_user_id}}/.local/bin/
+      stat:
+        path: "/home/{{ ansible_user_id }}/.local/bin/crc"
+      register: stat_result
+      when: stat_result.stat.exists == True
+
+    - name: Move crc from /tmp/crc-linux-{{crc_version}}-amd64 to /home/{{ansible_user_id}}/.local/bin
+      command: "mv /tmp/{{ crc_package_name }}/crc /home/{{ansible_user_id}}/.local/bin/"
+      when: stat_result.stat.exists == False
+
+    - name: crc libvirt group
+      shell: "crc config set skip-check-user-in-libvirt-group true"

kogito-ansible/playbook_create.yaml

@@ -0,0 +1,134 @@
+---
+  - name: Start CRC and deploy Kogito Operator and CLI
+    hosts: localhost
+
+    vars:
+      kogito_tag: "0.10.0"
+      ram: "16384" #MB
+      libvirt_version: "4.4.3"
+      ip_on_etc_hosts: 192.168.130.11
+      kube_password: "{{ lookup('file', '/home/{{ ansible_user_id }}/.crc/cache/crc_libvirt_{{ libvirt_version }}/kubeadmin-password') }}"
+      kogito_url_file: "https://github.com/kiegroup/kogito-cloud-operator/releases/download/{{ kogito_tag }}/kogito-cli-{{ kogito_tag }}-linux-amd64.tar.gz"
+      kogito_tmp_dest: "/tmp/kogito-{{ kogito_tag }}-linux-amd64.tar.gz"
+
+    vars_prompt:
+      - name: "nameSpace"
+        default: "my-kogito-project"
+        prompt: "Insert your Project Name/ NameSpace"
+        private: "no"
+      - name: "PullSecret"
+        prompt: "Insert your Pull secret"
+
+    tasks:
+      - debug: msg="Project Name {{ nameSpace }}"
+
+      - name: Check that kogito cli exists in /home/{{ansible_user_id}}/.local/bin/
+        stat:
+          path: "/home/{{ ansible_user_id }}/.local/bin/kogito"
+        register: stat_result
+
+      - name: Copy Kogito cli
+        get_url:
+          url: "{{kogito_url_file}}"
+          dest: "{{ kogito_tmp_dest }}"
+        when: stat_result.stat.exists == False
+
+      - name: Extract Kogito cli archive
+        unarchive:
+          src: "{{ kogito_tmp_dest }}"
+          dest: "/tmp/"
+        when: stat_result.stat.exists == False
+
+      - name: Creates user home kogito dir
+        file:
+          path: "/home/{{ ansible_user_id}}/.local/bin/"
+          state: directory
+        when: stat_result.stat.exists == False
+
+      - name: Move kogito from /tmp to /home/{{ansible_user_id}}/.local/bin
+        command: "mv /tmp/kogito /home/{{ansible_user_id}}/.local/bin/"
+        when: stat_result.stat.exists == False
+
+      - name: CRC setup
+        shell: "crc setup"
+        register: crc_result
+
+      - debug: msg="{{ crc_result }}"
+
+      - name: Write pull secret
+        copy:
+          content: "{{ PullSecret }}"
+          dest: "~/.crc/crc-pull-secret"
+
+      - name: Copy Kogito Examples pom
+        copy:
+          src: "./../pom.xml"
+          dest: "/tmp/examples_pom.xml"
+
+      - name: "Get Kogito Examples "
+        shell: xmllint --xpath '/*[local-name()="project"]/*[local-name()="modules"]' /tmp/examples_pom.xml > ~/.crc/quarkus_examples.txt
+
+      - name: Replace modules tags
+        replace:
+          path: ~/.crc/quarkus_examples.txt
+          regexp: '<modules>'
+          replace: ''
+
+      - name: Replace module tags
+        replace:
+          path: ~/.crc/quarkus_examples.txt
+          regexp: '<module>'
+          replace: '- '
+
+      - name: Replace end module tags
+        replace:
+          path: ~/.crc/quarkus_examples.txt
+          regexp: '</module>'
+          replace: ''
+
+      - name: Replace end modules tags
+        replace:
+          path: ~/.crc/quarkus_examples.txt
+          regexp: '</modules>'
+          replace: '\n'
+
+      - name: Start CRC with {{ ram }}MB (~ 10 minutes)
+        shell: "crc start -m {{ ram }} -p ~/.crc/crc-pull-secret"
+
+      - name: Login crc
+        shell: "oc login -u kubeadmin -p {{ kube_password }} https://api.crc.testing:6443"
+
+      - name: Create {{ nameSpace }}
+        shell: "oc new-project {{ nameSpace }}"
+
+      - name: Use {{ nameSpace }} proect
+        shell: "oc project {{ nameSpace }}"
+
+      - name: Kogito use {{ nameSpace }}
+        shell: "kogito use-project {{ nameSpace }}"
+        register: kogito_use_project_result
+        ignore_errors: yes
+
+      - debug: msg="{{ kogito_use_project_result }}"
+
+      - name: Kogito install operator on {{ nameSpace }}
+        shell: "kogito install operator -p {{ nameSpace }}"
+        register: kogito_install_operator_result
+
+      - name: Check AvailableReplica on Kogito operator first on {{ nameSpace }}
+        shell: "kubectl get pods --selector=name=kogito-operator -o jsonpath='{.items[*].status.phase}'"
+        register: result_one
+
+      - debug: msg="{{ result_one }}"
+
+      - name: Check AvailableReplica on Kogito operator first on {{ nameSpace }} wait for up to 120 sec, poll every 10 sec, 12 times
+        shell: "kubectl get pods --selector=name=kogito-operator -o jsonpath='{.items[*].status.phase}'"
+        register: result
+        until: result.stdout.find("Running") != -1
+        async: 120
+        poll: 10
+        retries: 12
+
+      - debug: msg="Project Name {{ nameSpace }}"
+
+      - debug: msg="Your Kube Password is {{ kube_password }}"

kogito-ansible/playbook_deploy.yaml

@@ -0,0 +1,55 @@
+---
+  - name: Start CRC 1.10.0 and deploy kogito examples
+    hosts: localhost
+
+    vars:
+      libvirt_version: "4.4.3"
+      ram: "16384" #MB   
+      kube_password: "{{ lookup('file', '/home/{{ ansible_user_id }}/.crc/cache/crc_libvirt_{{ libvirt_version }}/kubeadmin-password') }}"
+      examples: "{{  lookup('file', '~/.crc/quarkus_examples.txt') }}"
+      examples_repo: "https://github.com/kiegroup/kogito-examples/"
+
+    vars_prompt:
+      - name: "nameSpace"
+        prompt: "Insert your Project Name/ NameSpace"
+        default: "my-kogito-project"
+        private: "no"
+
+      - name: "example"
+        prompt: "Choose the example to deploy"
+        default: "\n{{ examples }}"
+        private: "no"
+
+    tasks:
+
+      - debug: msg="Project Name {{ nameSpace }}"
+
+      - name: Start CRC with {{ ram }}MB (~ 10 minutes)
+        shell: "crc start -m {{ ram }} -p ~/.crc/crc-pull-secret"
+
+      - name: Login crc
+        shell: "oc login -u kubeadmin -p {{ kube_password }} https://api.crc.testing:6443"
+        ignore_errors: yes 
+
+      - name: Kogito use {{ nameSpace }}
+        shell: "kogito use-project {{ nameSpace }}"
+        register: kogito_use_project_result
+        ignore_errors: yes
+
+      - debug: msg="{{ kogito_use_project_result }}"
+
+      - name: Deploy {{ example }}
+        shell: "kogito deploy-service {{ example }} {{ examples_repo }} --context-dir={{ example }}"
+        register: install_drools_quarkus_example
+        ignore_errors: yes
+
+      - debug: msg="{{ install_drools_quarkus_example }}"
+
+      - debug: msg="Project Name {{ nameSpace }}"
+
+      - debug: msg="Your Kube Password is {{ kube_password }}"
+
+      - name: Open browser
+        shell: "crc console"
+
+

kogito-ansible/playbook_libs.yaml

@@ -0,0 +1,25 @@
+---
+- name: Install libs on Fedora/Ubuntu
+  hosts: localhost
+
+  tasks:
+
+    - name: CheckOS
+      assert:
+        that:
+          - "ansible_os_family == 'Debian' or ansible_os_family == 'RedHat'"
+
+    - name: Install Virtualization on Ubuntu
+      apt:
+        pkg:
+          - qemu-kvm
+          - libvirt-daemon
+          - libvirt-daemon-system
+          - network-manager
+      become: yes
+      when: ansible_os_family == 'Debian'
+
+    - name: Install Virtualization on Fedora
+      shell: "sudo dnf install @virtualization -y"
+      become: yes
+      when: ansible_os_family == 'RedHat'