Usage
Deployed Resources
Once deployed, you should see the following in your AWS account:
Naming convention: <org>-<env>-<domain>-<module>-<resource>
SSM parameters: /<org>/<domain>/<module>/<resource-type>/<resource-name>/<attribute>
| Resource | Deployed Name / SSM Path | Config Reference |
|---|---|---|
| S3 Bucket | <org>-dev-shared-datalake-staging/<org>/shared/datalake/bucket/staging/name |
buckets.staging in datalake/datalake.yaml |
| S3 Bucket | <org>-dev-shared-datalake-raw/<org>/shared/datalake/bucket/raw/name |
buckets.raw in datalake/datalake.yaml |
| S3 Bucket | <org>-dev-shared-datalake-curated/<org>/shared/datalake/bucket/curated/name |
buckets.curated in datalake/datalake.yaml |
| Glue Database | <org>-dev-dataops-hda-project/<org>/dataops/hda-project/database/name |
projectName in dataops/project.yaml |
| Glue Job | <org>-dev-dataops-glue-jobs/<org>/dataops/glue-jobs/job/name |
configured in dataops/jobs.yaml |
| DynamoDB Table | <org>-dev-dataops-dynamodb-tables/<org>/dataops/dynamodb-tables/table/name |
configured in dataops/dynamodb.yaml |
| Lambda Function | <org>-dev-dataops-hda-function/<org>/dataops/hda-function/function/name |
configured in dataops/lambda.yaml |
| Step Functions State Machine | <org>-dev-dataops-file-workflow/<org>/dataops/file-workflow/state-machine/name |
configured in dataops/stepfunction.yaml |
| DMS Replication Task | <org>-dev-dataops-dms-test-task/<org>/dataops/dms/replication-task/name |
configured in dataops/dms.yaml |
| IAM Role | <org>-dev-shared-roles-data-admin/<org>/shared/generated-role/data-admin/id |
generateRoles.data-admin in roles.yaml |
| IAM Role | <org>-dev-shared-roles-data-user/<org>/shared/generated-role/data-user/id |
generateRoles.data-user in roles.yaml |
| IAM Role | <org>-dev-shared-roles-glue-etl/<org>/shared/generated-role/glue-etl/id |
generateRoles.glue-etl in roles.yaml |
| IAM Role | <org>-dev-shared-roles-dms/<org>/shared/generated-role/dms/id |
generateRoles.dms in roles.yaml |
Post-Deployment Steps
1. Verify DynamoDB Configuration Tables
The deployment hooks automatically populate DynamoDB configuration tables:
- load_table_info.sh table_config.json runs as a predeploy hook on the dms-shared module
- load_batch_config.sh runs as a postdeploy hook on the file-workflow module
These scripts are idempotent. You only need to re-run them manually if you update configuration after the initial deploy:
# Re-load table configuration after editing table_config.json
./dataops/scripts/load_table_info.sh table_config.json
# Re-load batch processing configuration after editing batch config
./dataops/scripts/load_batch_config.sh
2. Start the DMS Replication Task
- Navigate to AWS DMS Console > Database migration tasks.
- Select the task named
<org>-dev-dataops-dms-test-task(or find via SSM:/<org>/dataops/dms/replication-task/test-task/name). - Verify the source endpoint shows status "Successful" (if not, check connectivity to your source database).
- Click Actions > Restart/Resume to start replication.
3. Wait for Data Processing
The file processor and transformer Step Functions run on a schedule (configured via file_processor_event_bridge_trigger_hour in mdaa.yaml context).
To trigger manually for testing:
1. Navigate to AWS Step Functions Console.
2. Select the state machine named <org>-dev-dataops-file-workflow.
3. Click Start execution.
4. Verify Results
- Check the curated bucket (
<org>-dev-shared-datalake-curated) for transformed output files. - Navigate to AWS Glue Console > Databases >
<org>-dev-dataops-hda-projectand confirm tables are cataloged.