Skip to content
This repository was archived by the owner on Aug 9, 2023. It is now read-only.

Commit ead1c04

Browse files
committed
update readme with dist creation instructions
1 parent 77eeb21 commit ead1c04

File tree

1 file changed

+45
-0
lines changed

1 file changed

+45
-0
lines changed

README.md

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,51 @@
44

55
This repository is the source code for [Genomics Workflows on AWS](https://docs.opendata.aws/genomics-workflows). It contains markdown documents that are used to build the site as well as source code (CloudFormation templates, scripts, etc) that can be used to deploy AWS infrastructure for running genomics workflows.
66

7+
If you want to get the latest version of these solutions up and running quickly, it is recommended that you deploy stacks using the launch buttons available via the [hosted guide](https://docs.opendata.aws/genomics-workflows).
8+
9+
If you want to customize these solutions, you can create your own distribution using the instructions below.
10+
11+
## Creating your own distribution
12+
13+
Clone the repo
14+
15+
```bash
16+
git clone https://github.com/aws-samples/aws-genomics-workflows.git
17+
```
18+
19+
Create an S3 bucket in your AWS account to use for the distribution deployment
20+
21+
```bash
22+
aws s3 mb <dist-bucketname>
23+
```
24+
25+
Create and deploy a distribution from source
26+
27+
```bash
28+
cd aws-genomics-workflows
29+
bash _scripts/deploy.sh --asset-bucket s3://<dist-bucketname> test
30+
```
31+
32+
This will create a `dist` folder in the root of the project with subfolders `dist/artifacts` and `dist/templates` that will be uploaded to the S3 bucket you created above.
33+
34+
You can now use your deployed distribution to launch stacks using the AWS CLI. For example, to launch the GWFCore stack:
35+
36+
```bash
37+
TEMPLATE_ROOT_URL=https://<dist-bucketname>.s3-<region>.amazonaws.com/test/templates
38+
39+
aws cloudformation create-stack \
40+
--region <region> \
41+
--stack-name <stackname> \
42+
--template-url $TEMPLATE_ROOT_URL/gwfcore-root.template.yaml \
43+
--capabilities CAPABILITY_IAM CAPABILITY_AUTO_EXPAND \
44+
--parameters \
45+
ParameterKey=VpcId,ParameterValue=<vpc-id> \
46+
ParameterKey=SubnetIds,ParameterValue=\"<subnet-id-1>,<subnet-id-2>,...\" \
47+
ParameterKey=ArtifactBucketName,ParameterValue=<dist-bucketname> \
48+
ParameterKey=TemplateRootUrl,ParameterValue=$TEMPLATE_ROOT_URL
49+
50+
```
51+
752
## Building the documentation
853

954
The documentation is built using mkdocs.

0 commit comments

Comments
 (0)