= Deploy On-Demand Workshop
:toc:
:icons:
:linkattrs:
:imagesdir: ../resources/images


== Summary

Deploy a new AWS environment for use during this workshop. See the *Workshop Diagram* below for resources that will be created.

It will take approximately 12 minutes for the workshop environment to be created.

== Workshop Diagram

image::workshop-environment.png[align="center"]

=== Deploy the workshop using AWS CloudFormation

IMPORTANT: Read through all steps below before *_clicking_* the *Deploy to AWS* button.

//image::TBD.gif[align="left", width=600]

. Click on the *Deploy to AWS* button and follow the CloudFormation prompts to begin.

TIP: *_Context-click (right-click)_* the *Deploy to AWS* button and open the link in a new tab or window to make it easy to navigate between this github tutorial and the AWS Console.

|===
|Region | Launch template with a new VPC
| *N. Virginia* (us-east-1)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/new?stackName=fsx-openzfs-workshop&templateURL=https://s3.amazonaws.com/amazon-fsx/workshop/openzfs/templates/fsx-openzfs-od-workshop.yaml]

| *Ohio* (us-east-2)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=us-east-2#/stacks/new?stackName=fsx-openzfs-workshop&templateURL=https://s3.amazonaws.com/amazon-fsx/workshop/openzfs/templates/fsx-openzfs-od-workshop.yaml]

| *Oregon* (us-west-2)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=us-west-2#/stacks/new?stackName=fsx-openzfs-workshop&templateURL=https://s3.amazonaws.com/amazon-fsx/workshop/openzfs/templates/fsx-openzfs-od-workshop.yaml]

| *Tokyo* (ap-northeast-1)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=ap-northeast-1#/stacks/new?stackName=fsx-openzfs-workshop&templateURL=https://s3.amazonaws.com/amazon-fsx/workshop/openzfs/templates/fsx-openzfs-od-workshop.yaml]

| *Canada* (ca-central-1)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=ca-central-1#/stacks/new?stackName=fsx-openzfs-workshop&templateURL=https://s3.amazonaws.com/amazon-fsx/workshop/openzfs/templates/fsx-openzfs-od-workshop.yaml]

| *Ireland* (eu-west-1)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=eu-west-1#/stacks/new?stackName=fsx-openzfs-workshop&templateURL=https://s3.amazonaws.com/amazon-fsx/workshop/openzfs/templates/fsx-openzfs-od-workshop.yaml]

| *London* (eu-west-2)
a| image::deploy-to-aws.png[link=https://console.aws.amazon.com/cloudformation/home?region=eu-west-2#/stacks/new?stackName=fsx-openzfs-workshop&templateURL=https://s3.amazonaws.com/amazon-fsx/workshop/openzfs/templates/fsx-openzfs-od-workshop.yaml]
|===

. Accept the defaults on the *Prerequisite - Prepare template* page and *_click_* *Next*.
+
. Accept the default stack name and *_click_* *Next*. *_Enter_* values for all parameters.
+
[cols="3,10"]
|===
| *VPC CIDR*
a| Select a CIDR that will be used for the VPC.

| *Availability Zones*
a| Select an availability zone for your VPC.

| *Instance Type*
a| Accept default unless you want to use a larger instance type.

| *Key Pair*
a| Select your keypair.


|===
+
. After you have entered values for all parameters, *_click_* *Next*.
. *_Accept_* the default values of the *Configure stack options* and *Advanced options* sections and *_click_* *Next*.
. *_Review_* the CloudFormation stack settings.
. *_Click_* both checkboxes in the blue *Capabilities* box at the bottom of the page.
+
image::cloudformation-capabilities.png[align="left", width=420]
+
. *_Click_* *Create stack*.

The tutorial environment will be available in approximately 10 minutes.


== Resources

While the workshop environment gets created below are some recommended resources to get started with an overview of Amazon FSx for OpenZFS. *_Right-click_* on the below resources to open them in a new tab or window.


* link:https://youtu.be/hCcLcWPoTGA[Amazon FSx for OpenZFS Overview]
* link:https://aws.amazon.com/fsx/[Amazon FSx product page]


== Next section

Click the button below to go to the next section.

image::managing-openzfs-resources.png[link=../02-managing-openzfs-resources/, align="right",width=420]
