Web Service

Add a Web Service resource to your Altostra project

The Web Service resource creates an ECS Fargate Service.
To add Web Service resource in the designer, go to the "Compute" section and select the "Web Service" resource, or search "web" in the search box:

Web Service properties

Name:

type: string | required

• Altostra will use Name property for generating a logical ID:
  • Only strict alpha-numeric characters will be used (by the restrictions of CFN)
  • If non alpha-numeric characters were used in the name, the logical ID will be generated by the resource type
  • Up to 64 characters

vCPU:

type: number | required

• The number of cpu units reserved for the container.
• Allowed values
  • 0.25
  • 0.5
  • 1
  • 2
  • 4

Memory:

type: number | required

• The amount (in GiB) of memory to present to the container.
  • Allowed values are dependant on selected vCPU.
  • If your container attempts to exceed the memory specified, the container is killed.

Number of Instances:

type: number | required

• The number of instances of the web services to place and keep running in your cluster.

Image Name:

type: string | required

• The name of a container.
  • Up to 255 letters (uppercase and lowercase), numbers, underscores, and hyphens are allowed.

Image URI

type: string | required

• The image used to start a container.
  • This string is passed directly to the Docker daemon.
  • By default, images in the Docker Hub registry are available.
  • Other repositories are specified with either repository-url/image:tag or repository-url/image@digest.
  • Up to 255 letters (uppercase and lowercase), numbers, hyphens, underscores, colons, periods, forward slashes, and number signs are allowed.

Health Check Path

type: string | required

• The destination for health checks on the web service.

Port

type: number | required

• The port on which the web service receive traffic.

Vpc ID

type: string | required

• The identifier of the virtual private cloud (VPC) your web service is going to run.

Security Group IDs:

type: strings

• You can add multiple IDs, separated by commas.
• Each ID must begin with “sg-”, and must exist in your AWS account.
• You can set this field as a parameter.

Subnet IDs:

type: strings

• You can add multiple IDs, separated by commas.
• Each ID must begin with “subnet-”, and must exist in your AWS account.
• You can set this field as a parameter.

Environment Variables:

type: Name – Value pairs | optional

• The environment variables to pass to a container.
• You can set the value as a parameter.

Inline Policies:

type: JSON | optional

• You can add inline policies to your container.

• Must be a valid policy JSON:

  {
    "Version": "2012-10-17",
    "Statement": [
      {
        "Effect": "Allow",
        "Action": ["s3:ListBucket", "s3:ListBucketVersions"],
        "Resource": ["arn:aws:s3:::*/*"]
      }
    ]
  }
  • You can set the policy as a parameter.

Web Service Connections:

Web Service can connect to the following resources:

• Application Integration:
  • SNS Topic
  • SQS FIFO Queue
  • SQS Queue
• Database:
  • Aurora Cluster
  • Aurora Serverless Cluster
  • DynamoDB Table
  • RDS Instance
• Storage:
  • S3 Bucket
  • S3 Service
• Management & Governance:
  • Parameter Store (SSM)
• Analytics:
  • Kinesis Stream
• Machine Learning:
  • Recognition Service
• Business Application:
  • Simple Email Service