This is a Nullstone application module that provides a mechanism for launching EC2 instances (Virtual Machines).
The EC2 Instance module allows you to run custom workloads with custom configuration on an EC2 instance.
Instead of launching manually, this module provides access controls to use nullstone ssh
and easy configuration of access to other infrastructure (e.g. databases)
We intentionally do not run compliance scanning on this module because it is usually used for custom configuration. We do not want to provide you with a false sense of security. Instead, it will be up to your team to fully secure and administer compliance of this EC2 instance.
The EC2 instance is launched into private subnets on the connected network. The instance is accessible to other services on the private network (with proper security groups enabled).
The instance is not accessible from the internet unless a custom Ingress
capability is added to direct traffic to the instance.
The created EC2 instance is accessible via nullstone ssh
and does not require a bastion to access.
By default, this module will launch an EC2 instance using the latest Amazon Linux 2
virtual machine image.
To use a custom image, specify var.ami
with an authorized image that is available in the current AWS region.
In order for this app to work properly, the selected AMI must have the SSM Agent installed.
During provisioning, Nullstone configures the instance to start amazon-ssm-agent
on the instance during bootup.
Environment variables and secrets are not supported yet.
This module offers the following capability support at this time.
app_metadata.role_name
- Role Name attached to the EC2 instance. Accessible via EC2 Instance Metadata endpoint.app_metadata.security_group_name
- Security Group attached to the EC2 instance.outputs.public_urls
outputs.private_urls
outputs.env
outputs.secrets
outputs.load_balancers
outputs.mount_points