CloudFormation Deployment
Learn how to deploy Code Ocean via CloudFormation.
When you have completed prerequisites and have hosting domain information handy, you can continue deploying Code Ocean via AWS CloudFormation. Visit AWS CloudFormation's website for more information.
The deployment takes about 40 minutes to complete.
Usually Code Ocean CloudFormation stack is being managed by AWS account admins. However, if you wish to manage you Code Ocean CloudFormation stack using a least privileged CloudFormation deployment role, you can find it here. To avoid upgrades failures, we recommend to update the least privileged role stack prior to each Code Ocean upgrade.
Create CloudFormation Stack
Code Ocean deployment is publicly available via AWS S3. Go to AWS CloudFormation -> Stacks -> Create stack or follow this link, to autofill all the fields, to start creating a deployment stack in CloudFormation, with Code Ocean's latest release template.
The following steps are consistent with the steps of creating a stack in AWS CloudFormation.
Step 1 - Specify the template
Choose Template is ready in the Prerequisite section.
Choose Amazon S3 URL in the Specify template section.
Click Next.
Step 2 - Specify stack details
Most configuration parameters are set to the recommended defaults.
Choose a name for the deployment stack, the default will be
codeocean
.Set
DNS name
tocodeocean
.Set
DNS Root Domain
to the hosting domain (e.g.[company].com
). Visit Prerequisites if you need more information.Set
Availability Zone 1
andAvailability Zone 2
for the VPCScroll to the bottom and click Next.
Stack Parameters are set by default to their recommended values for the default internet-facing deployment type. Please visit Deployment Parameters page for the full list of parameters and their purpose. Note that there are some changes required according to AWS region and/or deployment type.
Please contact our support or email support@codeocean.com if you have any questions or you need help regarding parameters values.
Step 3 - Configure stack options (optional)
You can specify tags (key-value pairs) for resources in your stack and set advanced options.
Click Next when you are done.
Visit the Resource tag page on AWS for more information about specifying tags.
Visit the AWS CloudFormation stack options page on AWS for more information about advanced options.
Step 4 - Review
Review and assure that all the details are correct.
Check the box to acknowledge that CloudFormation might create IAM resources.
Click Create Stack to start the deployment.
After you click on Create Stack, you will be redirected to the stack screen where you can follow the progress of your stack deployment :
SSL Certificate Approval
This section applies only to deployments that use Email Validation to provision an ACM SSL certificate. When using DNS Validation, the SSL Certificate will be approved automatically.
For more information, please refer to the SSL Certificate Validation section.
For the deployment to be completed successfully, you or your IT administrator must approve the SSL certificate request. You will receive an email from AWS asking you to approve the certificate.
This email will be sent to the following email addresses:
administrator@your_domain_name
hostmaster@your_domain_name
postmaster@your_domain_name
webmaster@your_domain_name
admin@your_domain_name
To approve the certificate request:
Choose the Amazon Certificate Approvals link in the email.
Click I Approve on the page you get directed to.
Deployment Completion
When the deployment is finished, the state of the CloudFormation stack will turn into CREATE_COMPLETE
.
Post Deployment
Subscribing to AWS Alarms
We recommend subscribing to AWS Alarms, to prevent system issues. To subscribe and learn more about alarms, navigate to the Alarms help page.
Last updated