Skip to content

Commit c2e1d36

Browse files
committed
Update Blog “open-sourcing-workshops-on-demand-part2-deploying-the-backend”
1 parent 8a39730 commit c2e1d36

File tree

1 file changed

+26
-20
lines changed

1 file changed

+26
-20
lines changed

content/blog/open-sourcing-workshops-on-demand-part2-deploying-the-backend.md

Lines changed: 26 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,7 @@ It provides:
6060
* A fail2ban service
6161
* An Admin user to manage everything
6262
* A set of scripts to handle different tasks such as:
63+
6364
* Notebooks deployment
6465
* Jupyterhub compliancy
6566
* Users compliancy
@@ -92,11 +93,12 @@ When done with OS installation and preparation
9293
install$ git clone https://github.com/Workshops-on-Demand/wod-backend.git
9394
install$ cd wod-backend/
9495
```
96+
9597
* Examine default installation parameters and adapt when necessary accordingly. Files are self-documented.
9698

9799
Look at the following files within ansible/group_vars directory.
98100

99-
* `all.yml` file
101+
* `all.yml` file
100102

101103
```shellsession
102104
vi all.yml
@@ -276,23 +278,25 @@ WODFEAPIPWD: MotDePasseCompliquéAussi125!!!##
276278
* Installs minimal required (`ansible, git, jq, openssh server, npm`)
277279
* Creates an admin user as defined upper (default is `wodadmin`) with sudo rights
278280
* Calls the `install-system-common.sh` script that performs the following tasks:
279-
* Cleanup
280-
* Github repos cloning (leveraging install.repo file) : public Backend and public Private repos
281-
* Create ssh keys for wodadmin
282-
* Creates GROUPNAME variables
283-
* Creates Ansible inventory files
281+
282+
* Cleanup
283+
* Github repos cloning (leveraging install.repo file) : public Backend and public Private repos
284+
* Create ssh keys for wodadmin
285+
* Creates GROUPNAME variables
286+
* Creates Ansible inventory files
284287
* Calls the `install_system.sh` script with the type (backend, frontend, etc..) that performs the following tasks:
285-
* Install the necessary stack based on selected type
286-
* Create a `wod.sh` script in `wod-backend` directory to be used by all other scripts
287-
* Source the `wod.sh` file
288-
* Setup Ansible-galaxies (`community.general` and `posix`)
289-
* Setup Ansible and call the playbook `install_<type>.yml` followed by the `ansible\_check\_<type>.yml`
288+
289+
* Install the necessary stack based on selected type
290+
* Create a `wod.sh` script in `wod-backend` directory to be used by all other scripts
291+
* Source the `wod.sh` file
292+
* Setup Ansible-galaxies (`community.general` and `posix`)
293+
* Setup Ansible and call the playbook `install_<type>.yml` followed by the `ansible\_check\_<type>.yml`
290294

291295
At the end of the installation process:
292296

293-
* you will have a JupyterHub server running on port 8000
294-
* You will get a new `wodadmin` user (Default admin)
295-
* You will get a set of 20 students (Default value)
297+
* you will have a JupyterHub server running on port 8000
298+
* You will get a new `wodadmin` user (Default admin)
299+
* You will get a set of 20 students (Default value)
296300

297301
All playbooks are self-documented. Please check for details.
298302

@@ -316,23 +320,25 @@ The principle remains similar, with a few differences explained below.
316320
* Commit and push changes to your repo.
317321
* Create an `install.priv` file located in `install` directory when using a private repo (consider looking at [install.repo](https://github.com/Workshops-on-Demand/wod-backend/blob/main/install/install.repo) file for a better understanding of the variables).
318322
* Define the WODPRIVREPO and WODPRIVBRANCH variables as follows:
319-
* `WODPRIVBRANCH="main"`
320-
* `WODPRIVREPO="[email protected]:Account/Private-Repo.git wod-private"`
323+
324+
* `WODPRIVBRANCH="main"`
325+
* `WODPRIVREPO="[email protected]:Account/Private-Repo.git wod-private"`
321326

322327
**Note:** When using a token
323328

324329
Please refer to the following [url](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) to generate a `token` file in `install` directory of WoD-backend:
325330

326331
* Edit the `install.priv` file located in `install` directory of WoD-backend:
327-
* Create line before variable declaration: ``token=`cat $EXEPATH/token` ``
328-
* Use the token in the url WODPRIVREPO="git clone https://user:[email protected]/Account/wod-private.git wod-private"
332+
333+
* Create line before variable declaration: ``token=`cat $EXEPATH/token` ``
334+
* Use the token in the url WODPRIVREPO="git clone https://user:[email protected]/Account/wod-private.git wod-private"
329335

330336
You are now ready to perform the installation again to support a private repository.
331337

332-
Please note that this setup phase can be conccurent with the public setup phase. Indeed, the install script should detect the presence of the private repository owing to the presence of the install.priv file. It will automatically adjust the different scripts and variables to add the relevant content. It will actually overload some of the variables with private ones.
338+
Please note that this setup phase can be concurrent with the public setup phase. Indeed, the install script should detect the presence of the private repository owing to the presence of the install.priv file. It will automatically adjust the different scripts and variables to add the relevant content. It will actually overload some of the variables with private ones.
333339

334340
You now have a working Workshops-on-Demand backend server in place. Congratulations! The next article in the series will help you better understand the lifecycle of the backend server. How does a workshop registration work from the backend server 's side? How do you manage this server on a daily basis? How and when do you need to update it ? All these questions will be answered in the next article. And from there, we will move to the frontend side of things and finally to a workshop's creation process.
335341

336-
If you need support for this installation process, use our dedicated slack channel
342+
If you need support for this installation process, use our dedicated [slack channel](https://hpedev.slack.com/archives/C01B60X8SSD)
337343

338344
Please be sure to check back [HPE Developer blog site](https://developer.hpe.com/blog) to read all the articles in this series. Also, check out the Hack Shack for new [workshops](https://developer.hpe.com/hackshack/workshops) [Data Visualization 101](https://developer.hpe.com/hackshack/replays/42) is now available! HPE GreenLake for Compute Operations Management API 101 on its way too. Stay tuned!

0 commit comments

Comments
 (0)