Skip to content
Snippets Groups Projects

Resolve "Update deploy script documentation"

Merged Jorge Moratinos requested to merge 6-update-deploy-script-documentation into develop
1 file
+ 52
2
Compare changes
  • Side-by-side
  • Inline
 
- [Downloading the project](#downloading-the-project)
 
- [1. Create a folder to download the project](#1-create-a-folder-to-download-the-project)
 
- [2. Download the deployment script](#2-download-the-deployment-script)
 
- [3. Run the deployment script](#3-run-the-deployment-script)
- [Run All CAPIF Services locally with Docker images](#run-all-capif-services-locally-with-docker-images)
- [Run All CAPIF Services locally with Docker images](#run-all-capif-services-locally-with-docker-images)
- [Run All CAPIF Services locally with Docker images and deploy monitoring stack](#run-all-capif-services-locally-with-docker-images-and-deploy-monitoring-stack)
- [Run All CAPIF Services locally with Docker images and deploy monitoring stack](#run-all-capif-services-locally-with-docker-images-and-deploy-monitoring-stack)
- [Run each service using Docker](#run-each-service-using-docker)
- [Run each service using Docker](#run-each-service-using-docker)
@@ -5,6 +9,52 @@
@@ -5,6 +9,52 @@
Capif services are developed under [services folder](https://labs.etsi.org/rep/ocf/capif/-/tree/main/services).
Capif services are developed under [services folder](https://labs.etsi.org/rep/ocf/capif/-/tree/main/services).
 
### Downloading the project
 
 
You can easily download CAPIF to run in local environment following next steps:
 
 
#### 1. Create a folder to download the project
 
 
```
 
mkdir OpenCAPIF
 
 
cd OpenCAPIF
 
```
 
 
#### 2. Download the deployment script
 
 
Download the deployment / environment preparation script:
 
 
 
```
 
wget https://labs.etsi.org/rep/ocf/capif/-/raw/staging/deploy.sh
 
```
 
 
Make it executable:
 
 
```
 
chmod +x deploy.sh
 
```
 
 
#### 3. Run the deployment script
 
 
This script selects the branch for capif repository project to pull from.
 
 
If you run the script without selecting a branch the the main branch is going to be selected.
 
 
We recommend:
 
 
* **main** branch for the most stable experience and **staging** branch for an experience with the latest features (for staging branch installation, it is strongly advisable that you may as well follow the staging documentation)
 
 
```
 
# ./deploy.sh [branch to fetch] [true or false (default) to install monitoring stack or not]
 
 
sudo ./deploy.sh staging
 
```
 
 
 
> **We recommend running the deploy.sh script with root permissions! In other case, some directories may not be accessible by the project building tools and hinder the smooth installation.**
 
### Run All CAPIF Services locally with Docker images
### Run All CAPIF Services locally with Docker images
To run using docker and docker compose, version 2.10 or higher, you must ensure you have those tools installed in your machine. Also to simplify the process, we have 3 scripts allowing docker images to deploy, check and cleanup.
To run using docker and docker compose, version 2.10 or higher, you must ensure you have those tools installed in your machine. Also to simplify the process, we have 3 scripts allowing docker images to deploy, check and cleanup.
@@ -16,7 +66,7 @@ To run CAPIF APIs locally using docker and docker-compose you can use run.sh scr
@@ -16,7 +66,7 @@ To run CAPIF APIs locally using docker and docker-compose you can use run.sh scr
Usage: ./run.sh <options>
Usage: ./run.sh <options>
-c : Setup different hostname for capif
-c : Setup different hostname for capif
-m : Clean monitoring service
-m : Launch monitoring service
-h : show this help
-h : show this help
```
```
This script builds and runs all services using docker images, including mongodb and nginx locally and in the background, and imports ca.crt to nginx. By default monitoring is not activated and Nginx is deployed use **capifcore** as a hostname.
This script builds and runs all services using docker images, including mongodb and nginx locally and in the background, and imports ca.crt to nginx. By default monitoring is not activated and Nginx is deployed use **capifcore** as a hostname.
@@ -30,7 +80,7 @@ Some examples of use:
@@ -30,7 +80,7 @@ Some examples of use:
./run.sh -c opencapif.etsi.org
./run.sh -c opencapif.etsi.org
# opencapif.etsi.org as CAPIF_HOSTNAME and monitoring activated
# opencapif.etsi.org as CAPIF_HOSTNAME and monitoring activated
./run.sh -c opencapif.etsi.org -m true
./run.sh -c opencapif.etsi.org -m
```
```
Loading