Pablo Solar Vilariño
2020-06-11 d4a550812d90f1f23e74ba6bae81b74d74bec907
commit | author | age
4adf83 1 # Adopt a Pup Application
PSV 2
5ddca5 3 This application consists of the following services:
4adf83 4
5ddca5 5 - Adoption
PSV 6 - Animal
7 - Email
8 - Frontend
9 - Notification
10 - Shelter
4adf83 11
5ddca5 12 ## Deployment
4adf83 13
5ddca5 14 Note that this application is written for OpenShift Service Mesh.
PSV 15 The project where you deploy this application should be managed by OSSM
16 (i.e. be in the ServiceMeshMemberRoll resource).
bae328 17
14204b 18 1. Create a project for the news service.
PSV 19
20     ```
21     oc new-project comprehensive-review-news
22     ```
23
24 2. Deploy the news service.
25     ```
26     oc apply -f kubefiles/news-service.yaml
27     ```
28
29 3. Create a project for the Adopt a Pup application.
5ddca5 30     ```
PSV 31     oc new-project comprehensive-review
32     ```
bae328 33
8a7c93 34 4. Add the project to the list of SMMR members.
60c173 35     ```
PSV 36    oc edit smmr -n istio-system
37    ```
8a7c93 38
60c173 39    The list of members should look like:
PSV 40    ```
41    ...
42    spec:
43      members:
44      - comprehensive-review
45    ...
46    ```
14204b 47
PSV 48 5. Deploy the MongoDB container.
5ddca5 49     ```
PSV 50     sh scripts/deploy-mongo.sh
51     ```
8a7c93 52
5ddca5 53    See the script [parameters](scripts/deploy-mongo.sh) to customize the data import.
bae328 54
14204b 55 6. Populate the MongoDB database.
5ddca5 56     ```
PSV 57     sh scripts/populate-mongo.sh
58     ```
59    See the script [parameters](scripts/populate-mongo.sh) to customize the deployment.
bae328 60
14204b 61 7. Deploy the backend services.
5ddca5 62     ```
d4a550 63     oc apply -f kubefiles/service-mesh.yaml
5ddca5 64     oc apply -f kubefiles/adoption-service.yaml
PSV 65     oc apply -f kubefiles/animal-service.yaml
2cd9c5 66     oc apply -f kubefiles/email-service.yaml
8a7c93 67     oc apply -f kubefiles/notification-service.yaml
5ddca5 68     oc apply -f kubefiles/shelter-service.yaml
PSV 69     ```
bae328 70
14204b 71 8. Deploy the frontend.
5ddca5 72     ```
14204b 73     sh scripts/deploy-frontend.sh
PSV 74     ```
5ddca5 75    See the script [parameters](scripts/deploy-frontend.sh) to customize the deployment.
8a7c93 76
JR 77
78 ## Development
79
80 Use the following instructions if you need to do development in one of the application services.
81
82 ### Frontend web-app
83
84 For specific instructions about how to run the frontend web-app in development environments, head to
85 the [Frontend web-app README](web-app/README.md)
86
87 ### Backend services
88
89 TODO...