// Deploy a frontend tier stack: S3 static hosting + CloudFront distribution + OAC.
| name | ipa-stack-frontend |
| description | Deploy a frontend tier stack: S3 static hosting + CloudFront distribution + OAC. |
| model | opus |
Deploy a frontend tier stack: S3 static hosting + CloudFront distribution + OAC.
| Property | Value |
|---|---|
| Stack name | {APP_NAMESPACE}-{APP_ENV}-frontend |
| Template | infra/cfn/frontend/frontend.yml |
| Capabilities | None |
| Lifecycle | deploy (solution stack) |
| Tier | frontend |
| Parameter | Required | Default | Description |
|---|---|---|---|
| Namespace | Yes | — | Project namespace prefix |
| Environment | Yes | — | Deployment environment (dev/staging/prod) |
| BucketNameSuffix | No | web | Suffix for S3 bucket name |
| LogBucketDomainName | Yes | — | Log bucket domain name for access logs |
Parameters that receive values from other stacks during composition:
| Parameter | Source Stack | Source Output | Notes |
|---|---|---|---|
| LogBucketDomainName | logs | LogBucketName | Append .s3.amazonaws.com to output value |
| Output | Export Name | Description |
|---|---|---|
| AppUrl | {StackName}-AppUrl | CloudFront HTTPS URL |
| DistributionId | {StackName}-DistributionId | For cache invalidation |
| DistributionDomainName | {StackName}-DistributionDomainName | CloudFront domain |
| BucketName | {StackName}-BucketName | S3 bucket for upload |
| Type | Suffix | Dockerfile | Description |
|---|---|---|---|
| frontend | frontend | — | Build the React SPA in web-client/ via npm ci && npm run build. Note: this project's frontend directory is web-client, not the default frontend — the generated build-frontend target must cd web-client, not cd frontend. |
None — frontend tier has no conditional resources.
aws cloudformation deploy \
--template-file infra/cfn/frontend/frontend.yml \
--stack-name $(APP_NAMESPACE)-$(APP_ENV)-frontend \
--parameter-overrides \
Namespace=$(APP_NAMESPACE) \
Environment=$(APP_ENV) \
BucketNameSuffix=web \
LogBucketDomainName=$(LOG_BUCKET_DOMAIN_NAME)
Compose a deployment from stack skills and generate executable artifacts (Makefiles, security disposition). Use when the user says 'compose', 'generate deployment', or invokes /ipa-compose.
Deploy a CodePipeline CI/CD pipeline with CodeBuild for automated build/test/deploy.
Deploy one-time prerequisite infrastructure from scripts/prepare.mk. Use when the user says 'prepare', 'deploy prerequisites', 'create ECR', or invokes /ipa-prepare.
Provision or update centralized security infrastructure (IAM roles) for an IPA project. Use when the user says 'security', 'set up security', 'IAM roles', or invokes /ipa-security.
Deploy a centralized S3 log bucket for CloudFront, S3 access, and VPC flow logs.
[DEPRECATED] Use /ipa-compose codepipeline + /ipa-prepare instead.