App Diagrams

The default versions of all YAC containers can be found in the Docker
Hub under the nordstromsets repo. Feel free to override with your
preferred containers!

Use Cases

Verify your VPC

YAC uses keyword searches to find VPC ids and subnets for building its
cloud resources.

Use the following command to verify that yac can find your intended VPC
subnets.

yac vpc -h

Build your Stack

Build a stack for your Atlassian application via AWS cloud formation.
The stack includes all the AWS resources your application needs,
including ELBs, EC2 instances in an auto-scaling group, an RDS instance,
an EFS for shared home directories, and a containerized version of your
Atlassian app.

yac stack -h

For example, to build a jira stack tuned to support 500 users into your
production vpc, run.

yac stack jira –users=500

After the stack is built, EC2 instances in your stack will register with
ECS and downlooad and run the containers in your app. Simple!

A typical intance boot sequence is:

EC2 instance gets created per its auto-scaling group, then

ECS agent gets auto-installed, then

ECS agent “phones home” to ECS with its cluster ID, then

ECS agent downloads and runs cluster-specific containers

Setup a DB

Setup the DB and DB user on your RDS instance.

yac db setup -h

After the setup is complete, you can navigate to your Atlassian app and
execute the install wizard.

Restore Files from Backups

Your app includes a backups container that will backup files and
directories from your app to an S3 bucket. Files and directories can be
restored via:

yac restore -h

Restore a DB

The DB for your app is implemented as an RDS instance. The DB will
automatically take backups of itself for a configurable number of days.
Backups can be restored via:

yac db restore -h

Container Dev Use Cases

Need an Atlassian app version not yet available in the yac hub? Build
your own!

Build Images

Build image for a container to an EC2 instance

yac container build -h

Start Container

Start an individual container and test it out

yac container start -h

Push Your Container Image

Is you container looking good? Push to docker hub for others to enjoy…