This is an automated email from the ASF dual-hosted git repository.
machristie pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/airavata.git
The following commit(s) were added to refs/heads/master by this push:
new d84f04392c Ansible: update notes on how to create Ansible virtual
environment
d84f04392c is described below
commit d84f04392c74b8ba5c2ee3fc7d3a0f7500235eb3
Author: Marcus Christie <[email protected]>
AuthorDate: Tue Aug 2 15:18:48 2022 -0400
Ansible: update notes on how to create Ansible virtual environment
---
dev-tools/ansible/README.md | 41 ++++++++++++++++++++++++++---------------
1 file changed, 26 insertions(+), 15 deletions(-)
diff --git a/dev-tools/ansible/README.md b/dev-tools/ansible/README.md
index 210ff084d2..1f94a505c1 100644
--- a/dev-tools/ansible/README.md
+++ b/dev-tools/ansible/README.md
@@ -1,24 +1,27 @@
# airavata-ansible
-Ansible script to deploy Apache Airavata and PGA.
-There are ansible roles to install Airavata pre-requisites (RabbitMQ,
Zookeeper, MariaDB).
+Ansible script to deploy Apache Airavata and the Airavata Django Portal. There
+are ansible roles to install Airavata pre-requisites (RabbitMQ, Zookeeper,
+MariaDB).
## Ansible installation
Note: the following assumes a Bash shell.
-1. Download and install the latest version of Python 3.6. See
- https://www.python.org/downloads/ or use your system's package manager.
-2. Create a virtual environment in this directory
+1. Download and install the latest version of Python. Minimum required version
+ is 3.8. See https://www.python.org/downloads/ or use your system's package
+ manager.
+2. Create a virtual environment in this directory
cd airavata/dev-tools/ansible
- python3.6 -m venv ENV
+ python3 -m venv ENV
-3. Source the environment (you'll need to do this each time before using
ansible commands)
+3. Source the environment (you'll need to do this each time before using
+ ansible commands)
source ENV/bin/activate
-4. Install ansible and any other dependencies.
+4. Install ansible and any other dependencies.
pip install -r requirements.txt
@@ -27,28 +30,36 @@ Now you should be ready to run `ansible-playbook` and other
ansible commands.
## Supported OS with versions.
- Centos 7
+- Rocky Linux 8
- The PGA should also work on Ubuntu 16
## Roles
-- **env_setup** :- Create user and group, install oracle java 8, open firewall
ports.
+- **env_setup** :- Create user and group, install oracle java 8, open firewall
+ ports.
- **zookeeper** :- Download and install zookeeper.
- **rabbitmq** :- Download and install rabbitmq as service.
- **database** :- Download and install mysql(mariadb) as a service.
-- **common** :- Checkout Airavata source from git and run maven build. Move
keystore files.
+- **common** :- Checkout Airavata source from git and run maven build. Move
+ keystore files.
- **gfac** :- Setup and deploy Gfac component.
- **registry** Setup and deploy registry component.
- **api-orch** :- Setup and deploy Api-Orch components.
- **pga** :- Setup and deploy Airavata PHP Gateway.
-- **keycloak** :- Setup and deploy Keycloak Identity management server. (Note:
Check roles/keycloak/README.md for details)
+- **keycloak** :- Setup and deploy Keycloak Identity management server. (Note:
+ Check roles/keycloak/README.md for details)
## Useful commands
-- Deploy database: `ansible-playbook -i inventories/path/to/inventory/dir
database.yml`
-- Deploy Airavata middleware: `ansible-playbook -i
inventories/path/to/inventory/dir airavata.yml`
-- Deploy Keycloak IAM server: `ansible-playbook -i
inventories/path/to/inventory/dir keycloak.yml`
+- Deploy database:
+ `ansible-playbook -i inventories/path/to/inventory/dir database.yml`
+- Deploy Airavata middleware:
+ `ansible-playbook -i inventories/path/to/inventory/dir airavata.yml`
+- Deploy Keycloak IAM server:
+ `ansible-playbook -i inventories/path/to/inventory/dir keycloak.yml`
- Deploy PGA: `ansible-playbook -i inventories/path/to/inventory/dir pga.yml`
-- Deploy everything: `ansible-playbook -i inventories/path/to/inventory/dir
site.yml`
+- Deploy everything:
+ `ansible-playbook -i inventories/path/to/inventory/dir site.yml`
## Configurations
