Install Ansible dependencies

ansible-galaxy collection install community.hashi\_vault
pip3 install hvac

Obtain postgres password

# Get JDBC_PASSWORD: 
oc -n postgres get secret/postgres-cluster-pguser-smartvillage -o jsonpath='{.data.password}' | base64 -d; echo

Obtain kafka secrets

# Get KAFKA_SSL_KEYSTORE_LOCATION: 
oc extract -n smart-village-view secret/smartvillage-kafka --to=$HOME/.local/src/smartabyar-smartvillage/config/ --keys=user.p12 --confirm

# Get KAFKA_SSL_KEYSTORE_PASSWORD: 
oc -n smart-village-view get secret/smartvillage-kafka -o jsonpath='{.data.user\.password}' | base64 -d; echo

# Get KAFKA_SSL_TRUSTSTORE_LOCATION: 
oc extract -n smart-village-view secret/smartvillage-kafka-cluster-ca-cert --to=$HOME/.local/src/smartabyar-smartvillage/config/ --keys=ca.p12 --confirm

# Get KAFKA_SSL_TRUSTSTORE_PASSWORD: 
oc -n smart-village-view get secret/smartvillage-kafka-cluster-ca-cert -o jsonpath='{.data.ca\.password}' | base64 -d; echo

Setup smartvillage-platform development environment on MacOSX or Linux (Fedora, RHEL, CentOS, Ubuntu)

Install Ansible dependencies on Linux

pkcon install -y git
pkcon install -y python3
pkcon install -y python3-pip
pip install virtualenv psycopg2-binary openshift

Install Ansible dependencies on MacOSX

brew install git python gnu-tar
pip3 install virtualenv

Install the latest Python and setup a new Python virtualenv

This step might be virtualenv-3 for you.

virtualenv ~/python

source ~/python/bin/activate
echo "source ~/python/bin/activate" | tee -a ~/.bashrc
source ~/.bashrc

Install the latest Ansible

pip install setuptools_rust wheel
pip install --upgrade pip
pip install ansible

Update the Ansible Galaxy collections for kubernetes.core

ansible-galaxy collection install kubernetes.core

Update the Ansible Galaxy collections for kubernetes.core

ansible-galaxy collection install kubernetes.core

Setup the project

Setup the directory for the project and clone the git repository into it

install -d ~/.local/src/smartvillage-platform
git clone [email protected]:computate-org/smartvillage-platform.git ~/.local/src/smartvillage-platform

Setup the Ansible Galaxy roles for installing the complete project locally.

install -d ~/.ansible/roles
git clone [email protected]:computate-org/computate_project.git ~/.ansible/roles/computate.computate_project

Run the Ansible Galaxy roles to install the complete project locally.

ansible-playbook ~/.ansible/roles/computate.computate_project/install.yml -e SITE_NAME=smartvillage-platform -e ENABLE_CODE_GENERATION_SERVICE=true

Running the project build and test suite

The smartvillage-platform project uses Maven to build and test the software. You can run the build and test suite with this command:

cd ~/.local/src/smartvillage-platform
mvn clean install

Running the project install to override secret variables

You can also inject your own secret variables with an Ansible Vault into the project install automation if you want to override any values.

Here is an example of creating a vault directory and creating a new vault, it will ask for a password. Be sure to not commit your vault to source control, it should be ignored by default in the .gitignore file that is created in the project.

install -d ~/.local/src/smartvillage-platform-ansible/vault
ansible-vault create ~/.local/src/smartvillage-platform-ansible/vault/$USER-local

You can edit the vault, it will ask for the password.

ansible-vault edit ~/.local/src/smartvillage-platform-ansible/vault/$USER-local

You can then run the project install automation again with the secrets in the vault, it will ask for the password.

ansible-playbook ~/.ansible/roles/computate.computate_project/install.yml -e SITE_NAME=smartvillage-platform -e ENABLE_CODE_GENERATION_SERVICE=true -e @~/.local/src/smartvillage-platform-ansible/vault/$USER-local --vault-id @prompt

Configure Eclipse IDE

You can download Eclipse Installer here:

https://www.eclipse.org/downloads/packages/

After you download the Eclipse installer, create a directory for it and extract it with this command:

install -d ~/.local/opt/eclipse-installer
tar xvf ~/Downloads/eclipse-inst-jre-linux64.tar.gz -C ~/.local/opt/eclipse-installer --strip-components=1

Now run the Eclipse installer:

~/.local/opt/eclipse-installer/eclipse-inst

• Select [ Eclipse IDE for Java Developers ]
• I recommend installing Eclipse in the following subdirectory of your home directory: .local/opt/eclipse
• Click [ Accept Now ] for the User Agreement

When you run Eclipse Studio, I suggest you create your workspace here: ~/.local/src

Install these update sites:

In Eclipse, go to Help -> Install New Software...

Add these update sites and install these useful plugins:

Vrapper Vim Plugin

• http://vrapper.sourceforge.net/update-site/stable
  • Choose the "Vrapper" plugin if you want to be able to edit code with Vim commands
  • Vrapper keys to unbind in Window -> Preferences -> General -> Keys:
    • ctrl+d, ctrl+u, ctrl+r, shift+ctrl+v, alt+v
  • Vrapper keys to set:
    • and search for "Vrapper" and set the keys to alt+v

DevStyle for dark theme

• http://www.genuitec.com/updates/devstyle/ci/
  • Choose "DevStyle Features" for themes

YAML Editor

• http://www.genuitec.com/updates/devstyle/ci/
  • Choose "DevStyle Features" for themes

Import the smartvillage-platform project into Eclipse

• In Eclipse, go to File -> Import...
• Select Maven -> Existing Maven Projects
• Click [ Next > ]
• Browse to the directory: ~/.local/src/smartvillage-platform
• Click [ Finish ]

Setup a Eclipse Debug/Run configuration to generate the OpenAPI 3 spec and the SQL create and drop scripts in smartvillage-platform

• In Eclipse, go to File -> Debug Configurations...
• Right click on Java Application -> New Configuration
• Name: smartvillage-platform-OpenAPIGenerator
• Project: smartvillage-platform
• Main class: org.computate.smartvillage.enus.vertx.MainVerticle

In the Environment tab

Setup the following variables to setup the Vert.x verticle.

• CONFIG_PATH: ~/.local/src/smartvillage-platform/config/smartvillage-platform.yml
• RUN_OPENAPI3_GENERATOR: true
• RUN_SQL_GENERATOR: true
• RUN_FIWARE_GENERATOR: true

Click [ Apply ] and [ Debug ] to debug the generation of the OpenAPI Spec src/main/resources/webroot and the SQL create and drop scripts in src/main/resources/sql.

Setup a Eclipse Debug/Run configuration to run and debug smartvillage-platform

• In Eclipse, go to File -> Debug Configurations...
• Right click on Java Application -> New Configuration
• Name: smartvillage-platform
• Project: smartvillage-platform
• Main class: org.computate.smartvillage.enus.vertx.MainVerticle

In the "Arguments" tab

Setup the following VM arguments to disable caching for easier web development:

-DfileResolverCachingEnabled=false -Dvertx.disableFileCaching=true

In the Environment tab

Setup the following variables to setup the Vert.x verticle.

• CONFIG_PATH: ~/.local/src/smartvillage-platform/config/smartvillage-platform.yml
• VERTXWEB_ENVIRONMENT: dev

Click [ Apply ] and [ Debug ] to debug the application.

Deploy smartvillage-platform to OpenShift with Ansible

To deploy smartvillage-platform to OpenShift with Ansible, you will want to follow the instructions to install Ansible on your system first above "Install Ansible dependencies on Linux".

Setup ~/.ansible/roles directory

A default place to install Ansible roles from Ansible Galaxy is in ~/.ansible/roles. Make sure this directory exists:

install -d ~/.ansible/roles

Clone the Ansible roles for deploying the applications to OpenShift

git clone [email protected]:computate-org/computate_postgres_openshift.git ~/.ansible/roles/computate.computate_postgres_openshift
git clone [email protected]:computate-org/computate_zookeeper_openshift.git ~/.ansible/roles/computate.computate_zookeeper_openshift
git clone [email protected]:computate-org/computate_solr_openshift.git ~/.ansible/roles/computate.computate_solr_openshift
git clone [email protected]:computate-org/computate_project_openshift.git ~/.ansible/roles/computate.computate_project_openshift

Create an ansible vault for your OpenShift.

You can create and edit an encrypted ansible vault with a password for the host secrets for your shared OpenShift inventory to deploy smartvillage-platform. It will have you create a password when you save the file for the first time, like using vim to exit.

install -d ~/.local/src/smartvillage-platform-ansible
install -d ~/.local/src/smartvillage-platform-ansible/vault/$USER-staging/vault
ansible-vault create ~/.local/src/smartvillage-platform-ansible/vault/$USER-staging/vault
ansible-vault edit ~/.local/src/smartvillage-platform-ansible/vault/$USER-staging/vault

Here is an example of a vault that I have used to deploy the smartvillage-platform application. You will want to update these values to reflect your OpenShift environment, like the REDHAT_OPENSHIFT_TOKEN which you will need to obtain after logging into OpenShift. Or the REDHAT_OPENSHIFT_STORAGE_CLASS_NAME which might be different than gp2 for you. If so, try creating a persistent volume in the UI to figure out a good storage class for your environment:

SITE_NAME: smartvillage-platform

REDHAT_OPENSHIFT_HOST: https://api.rh-us-east-1.openshift.com
REDHAT_OPENSHIFT_TOKEN: OcrtrXzKNKVj0riR2FvfqORgGfnURx98G8zRPd2MUvs
REDHAT_OPENSHIFT_NAMESPACE: rh-impact
REDHAT_OPENSHIFT_STORAGE_CLASS_NAME: gp2

POSTGRES_DB_NAME: sampledb
POSTGRES_DB_USER: computate
POSTGRES_DB_PASSWORD: qVTaaa23aIkLmw
POSTGRES_VOLUME_SIZE: 1Gi
POSTGRES_STORAGE_CLASS_NAME: "{{ REDHAT_OPENSHIFT_STORAGE_CLASS_NAME }}"

ZOOKEEPER_VOLUME_SIZE: 1Gi
ZOOKEEPER_STORAGE_CLASS_NAME: "{{ REDHAT_OPENSHIFT_STORAGE_CLASS_NAME }}"

SOLR_VOLUME_SIZE: 2Gi
SOLR_STORAGE_CLASS_NAME: "{{ REDHAT_OPENSHIFT_STORAGE_CLASS_NAME }}"

AUTH_REALM: SMARTVILLAGE
AUTH_CLIENT: smartvillage
AUTH_SECRET: ...
AUTH_HOST_NAME: sso.computate.org
AUTH_PORT: 443
AUTH_SSL: true
AUTH_TOKEN_URI: "/auth/realms/SMARTVILLAGE/protocol/openid-connect/token"

Run the Ansible automation to deploy the applications to OpenShift

ansible-playbook --vault-id @prompt -e @~/.local/src/smartvillage-platform-ansible/vault/$USER-staging/vault ~/.ansible/roles/computate.computate_postgres_openshift/install.yml -e SITE_NAME=smartvillage-platform

ansible-playbook --vault-id @prompt -e @~/.local/src/smartvillage-platform-ansible/vault/$USER-staging/vault ~/.ansible/roles/computate.computate_zookeeper_openshift/install.yml -e SITE_NAME=smartvillage-platform

ansible-playbook --vault-id @prompt -e @~/.local/src/smartvillage-platform-ansible/vault/$USER-staging/vault ~/.ansible/roles/computate.computate_solr_openshift/install.yml -e SITE_NAME=smartvillage-platform

ansible-playbook --vault-id @prompt -e @~/.local/src/smartvillage-platform-ansible/vault/$USER-staging/vault ~/.ansible/roles/computate.computate_project_openshift/install.yml -e SITE_NAME=smartvillage-platform

How to run the application as a Podman container

Install the prerequiste packages for buildah and podman

pkcon install -y buildah
pkcon install -y podman

Build the container with podman

cd ~/.local/src/smartvillage-platform
podman build -t computateorg/smartvillage-platform:latest .

Push the container up to quay.io

podman login quay.io
podman push computateorg/smartvillage-platform:latest quay.io/computateorg/smartvillage-platform:latest