Deployment Steps - Spatial Data Management on AWS
Step 1: Launch stackStep 2: Configure Stack DetailsStep 3: Specify Stack ParametersStep 4: Configure Stack OptionsStep 5: Review and CreateStep 6: Monitor Deployment ProgressStep 7: Retrieve OutputsNested Stacks

Deployment Steps

Step 1: Launch stack

Option 1: Launch directly in AWS Console

Choose the following link to launch the CloudFormation stack directly in the AWS Management Console:

Launch CloudFormation Console

This opens the CloudFormation console with the template pre-loaded. You can select your preferred AWS Region from the console before proceeding.

Option 2: Download and upload template file

You can also download the template and upload it manually:

  1. Download the CloudFormation template

  2. Open the CloudFormation console

  3. Choose Create stack, and then choose With new resources (standard)

  4. Under Specify template, choose Upload a template file

  5. Choose Choose file and select the downloaded template

  6. Choose Next

Create stack page showing template selection options

Step 2: Configure Stack Details

Enter the stack name (for example, SpatialDataManagement) and configure basic options.

Note

If you choose a different stack name, replace SpatialDataManagement with your chosen name in all CLI commands throughout this guide.

Stack details page showing default parameters for development deployment

Step 3: Specify Stack Parameters

You can configure the deployment parameters based on your environment.

Key parameters to configure:

Parameter Description Default Valid Values

DeploymentMode

Deployment environment – Dev or Prod. You can use this to configure scale and cost tendencies

dev

dev, prod

Optional Parameters

Parameter Description Default Valid Values

LogBucketRetentionDays

Number of days to retain logs in the log bucket

90

Any positive integer

PortalFullyQualifiedDomainName

Fully qualified domain name for custom domain

Empty

Valid domain name or empty

PortalRoute53HostedZoneId

Route53 hosted zone ID for custom domain

Empty

Valid Route53 hosted zone ID (starts with Z) or empty

ExistingDeadlineFarmId

ID of the Deadline Cloud Farm to use for jobs

Empty

Valid Deadline Cloud Farm ID (farm-<32 hex chars>) or empty

ExistingDeadlineQueueId

ID of the Deadline Cloud Queue to use for jobs

Empty

Valid Deadline Cloud Queue ID (queue-<32 hex chars>) or empty
Advanced parameters configuration for production deployment

Step 4: Configure Stack Options

You can set additional stack options:

You can configure the following options:

  • Stack policy (optional) – Defines which IAM actions are allowed on specific resources. For more information, see Prevent updates to stack resources in the AWS CloudFormation User Guide.

  • Rollback configuration – Specifies whether to roll back the stack if creation fails. For more information, see Stack creation options in the AWS CloudFormation User Guide.

  • Notification options – Specifies Amazon SNS topics to receive stack-related notifications. For more information, see Monitoring stack creation and updates in the AWS CloudFormation User Guide.

  • Tags – Key-value pairs for resource organization and cost allocation. For more information, see Tagging resources in the AWS CloudFormation User Guide.

CloudFormation stack options page showing basic configuration settings
CloudFormation stack options page showing permissions and advanced settings
CloudFormation stack options page showing tags and additional configuration

Step 5: Review and Create

Review your configuration and choose Create stack to begin deployment. The stack creation typically takes approximately 45 minutes to complete.

Review page showing stack parameters and configuration summary
Review page showing capabilities acknowledgment and create button

Step 6: Monitor Deployment Progress

You can monitor stack creation progress in the CloudFormation console:

  1. Open the CloudFormation console

  2. Select your stack (SpatialDataManagement)

  3. Choose the Events tab to view real-time creation progress

  4. Watch for the CREATE_COMPLETE status

For more information, see Monitoring stack creation, update, and deletion progress in the AWS CloudFormation User Guide.

Step 7: Retrieve Outputs

After successful deployment:

  1. Open the CloudFormation console

  2. Select your stack (SpatialDataManagement)

  3. Choose the Outputs tab to view deployment outputs

  4. Copy the output values for use in post-deployment configuration

Nested Stacks

The main stack creates the following nested stacks:

  1. VPC Stack (5-7 minutes) – Amazon Virtual Private Cloud (Amazon VPC) with 2 Availability Zones – Public, private, and isolated subnets – NAT gateways – VPC endpoints for AWS services

  2. Auth Stack (3-5 minutes) – Amazon Cognito user pool for authentication – Amazon Cognito identity pool for authorization – User and group management

  3. Asset Management Stack (5-8 minutes) – Amazon DynamoDB tables for asset metadata – AWS Lambda functions for API operations – Amazon Simple Storage Service (Amazon S3) buckets for asset storage – Amazon Simple Queue Service (Amazon SQS) queues for asynchronous processing – Amazon API Gateway for REST endpoints

  4. OpenSearch Stack (3-5 minutes) – Amazon OpenSearch Serverless collection – VPC endpoint for private access – Security and network policies

  5. Portal Stack (2-3 minutes) – Amazon CloudFront distribution for content delivery – S3 bucket for web assets – CloudFront key pair for signed URLs

  6. Deadline Stack (2-3 minutes, if enabled) – AWS Deadline Cloud farm configuration – Integration with asset management system – Job queue setup

  7. Monitoring Stack (2-3 minutes) – Amazon CloudWatch alarms and dashboards – AWS CloudTrail for audit logging – Amazon Athena workgroup for log analysis