You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .github/PULL_REQUEST_TEMPLATE.md
+5Lines changed: 5 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,11 @@
1
1
**Description**
2
2
A description of the PR, should include a decent explanation as to why this change was needed and a decent explanation as to what this change does
3
3
4
+
5
+
**Review Instructions**
6
+
Describe if this ticket needs review and if so, how one may go about it in qa and/or staging environments.
7
+
For example, a ticket based on Security Hub, Snyk, or Dependabot may not need review since those services will generate new warnings if the issue has not been resolved properly. On the other hand, an infrastructure ticket that results in visible changes to the end-user will definitely require review. Many tickets will likely be between these two extremes, so some judgement may be required.
8
+
4
9
**Issue**
5
10
A link to a github issue or SEAB- ticket (using that as a prefix)
This project documents how to setup Dockstore staging and production using composed Docker containers.
2
+
This project contains configuration template files needed to run Dockstore using AWS Fargate. View the [dockstore-deploy repository](https://github.com/dockstore/dockstore-deploy)
3
+
for more information about how Dockstore is setup using AWS Fargate.
3
4
Log issues and see general documentation at [dockstore](https://github.com/ga4gh/dockstore/issues) and [docs.dockstore.org](https://docs.dockstore.org/) respectively
4
5
5
-
Port 80 is exposed over http. This port should not be exposed to the public. A separately [configured load
6
-
balancer](https://github.com/dockstore/dockstore-deploy) is responsible for SSL termination and forwarding traffic to this instance. Previously this repo handled the SSL termination with nginx and LetsEncrypt.
7
-
8
6
If you are looking for how to run Dockstore locally as a developer, you are probably in the wrong place and should take a look at https://github.com/dockstore/dockstore/blob/develop/docker-compose.yml
9
7
10
8
## Prerequisities
@@ -17,24 +15,16 @@ If you are looking for how to run Dockstore locally as a developer, you are prob
17
15
18
16
## Usage
19
17
20
-
1. Call the install\_bootstrap script. This templates the contents of `templates` using mustache to the `config` directory while recording your answers for future use. Note that this will also
21
-
rebuild your docker images without affecting existing running containers
18
+
1. Call the install\_bootstrap script. This templates the contents of `templates` using mustache to the `config` directory while recording your answers for future use.
22
19
23
20
2. Some additional information on the answers requested in the script
24
21
1. Each integration requires a client id and a secret, it is worth saying that you should not check these in
25
22
2. The discourse URL is needed to link Dockstore to a discussion forum
26
23
3. the Google verification code and tag manager ID are used if you want to properly track visitors to Dockstore and what pages they browse to
27
24
28
-
3. The bootstrap script can also rebuild your Docker images. Keep in mind the following handy commands:
29
-
1.`install_bootstrap --script` will template and build everything using your previous answers (useful for quick iteration)
30
-
2.`docker-compose down` will bring all containers down safely
31
-
3.`nohup docker-compose up --force-recreate --remove-orphans >/dev/null 2>&1 &` will re-create all containers known to docker-compose and delete those volumes that no longer are associated with running containers
32
-
4.`docker system prune` for cleaning out old containers and images
33
-
5. To watch the logs `docker-compose logs --follow` while debugging
34
-
35
-
4. After following the instructions in the bootstrap script and starting up the site with `docker-compose`, you can browse to the Dockstore site hosted at port 443 by default. `https://<domain-name>` if you specified https or `http://<domain-name>:443` if you did not.
25
+
3. After following the instructions in the bootstrap script and starting up the site with AWS Fargate, you can browse to the Dockstore site hosted at port 443 by default using `https://<domain-name>`.
36
26
37
-
The current setup relies upon an externally hosted database (currently AWS RDS) and externally hosted search (currently AWS Elasticsearch).
27
+
The current setup relies upon an externally hosted container orchestration service (current AWS ECS with Fargate), externally hosted database (currently AWS RDS) and externally hosted search (currently AWS Elasticsearch).
38
28
39
29
### Loading Up a Database ###
40
30
@@ -45,15 +35,15 @@ Note that database migration is run once during the startup process and is contr
45
35
46
36
## Logging Usage
47
37
48
-
If using with logstash in a container (for development), use `-f docker-compose.yml -f docker-compose.dev.yml` flags after each `docker-compose` command to merge docker-compose files (e.g. `docker-compose -f docker-compse.yml -f docker-compose.dev.yml build`)
38
+
If using with logstash in a container (for development), use `-f docker-compose.yml -f docker-compose.dev.yml` flags after each `dockercompose` command to merge docker-compose files (e.g. `dockercompose -f docker-compse.yml -f docker-compose.dev.yml build`)
49
39
50
40
For example to deploy just logging
51
41
52
42
```
53
-
docker-compose -f docker-compose.dev.yml build
54
-
nohup docker-compose -f docker-compose.dev.yml up --force-recreate --remove-orphans >/dev/null 2>&1 &
55
-
docker-compose -f docker-compose.dev.yml down
56
-
docker-compose -f docker-compose.dev.yml kill
43
+
dockercompose -f docker-compose.dev.yml build
44
+
nohup dockercompose -f docker-compose.dev.yml up --force-recreate --remove-orphans >/dev/null 2>&1 &
45
+
dockercompose -f docker-compose.dev.yml down
46
+
dockercompose -f docker-compose.dev.yml kill
57
47
```
58
48
59
49
### Kibana Dashboard Setup ###
@@ -72,3 +62,10 @@ npm run install-git secrets
72
62
This should install git secrets into your local repository and perform a scan.
73
63
If secrets are found, the run will error and output the potential secret to stdout.
74
64
If you believe the scan is a false-positive, add the line glob to .gitallowed.
65
+
66
+
## Handy docker-compose commands:
67
+
1. `install_bootstrap --script` will template and build everything using your previous answers (useful for quick iteration)
68
+
2. `docker compose down` will bring all containers down safely
69
+
3. `nohup docker compose up --force-recreate --remove-orphans >/dev/null 2>&1 &` will re-create all containers known to docker-compose and delete those volumes that no longer are associated with running containers
70
+
4. `docker system prune` for cleaning out old containers and images
71
+
5. To watch the logs `docker compose logs --follow` while debugging
0 commit comments