AWS
Ops can integrate with your existing Amazon Web Services (AWS) account. You can use the Ops CLI to create and upload an image in your AWS account. Once, you have uploaded the image, you can also create an instance with a particular image using CLI.
We currently automate installing a vmimport role (https://docs.aws.amazon.com/vm-import/latest/userguide/vmimport-troubleshooting.html). It needs to be tied to the bucket you use and uses an unique name. If you are having trouble you might wish to see if you have an existing vmimport role defined already.
Nanos supports running on many of the AWS instance types including normal instance types like t2 and the newer Nitro based instances such as t3, c5, etc.
We currently don't have support for ARM based instances.
Ensure your ~/.aws/credentials file is setup correctly - you can use the 'aws ec2' cli tools to verify this.
Create a bucket in S3 storage for ami creation.
If you have already created an Ops project, you can update your existing config.json. You need to add CloudConfig which mentions specific details like ProjectID, BucketName.
{"CloudConfig" :{"ProjectID" :"prod-1000","Zone": "us-west-1","BucketName":"my-s3-bucket"}}
Once, you have updated config.json you can create an image in AWS with the following command:
For creating an image using a particular package, you need to provide the package name to ops image create command with -p option.
$ ops image create -t aws -c config.json -p node_v14.2.0 -a ex.js
You can list existing images on AWS with ops image list.
$ ops image list -t aws -z us-west-1+----------------+-----------+--------------------------+| NAME | STATUS | CREATED |+----------------+-----------+--------------------------+| nanos-webg-ata | available | 2019-07-16T05:56:06.000Z |+----------------+-----------+--------------------------+| will-00 | available | 2019-08-07T20:21:19.000Z |+----------------+-----------+--------------------------+| nanos-webg | available | 2019-07-16T05:01:44.000Z |+----------------+-----------+--------------------------+| node-image | available | 2019-08-15T22:31:03.000Z |+----------------+-----------+--------------------------+
ops image delete -i <imagename> can be used to delete an image from AWS.
$ ops delete image -i nanos-main-image
After the successful creation of an image in AWS, we can create an instance from an existing image.
$ ops instance create <image_name>
Alternatively, you can pass project-id and zone with cli options.
$ ops instance create <image_name> -p prod-1000 -z us-west-2
You can also pass config, if you have mentioned project-id and zone in project's config.json.
$ ops instance create <image_name> -c config.json
You can provide list of ports to be exposed on aws instance via config and command line.
CLI example
$ ops instance create <image_name> -p prod-1000 -z us-west-2 --port 80 --port 443
Sample config
{"CloudConfig" :{"Platform" :"aws","ProjectID" :"prod-1000","Zone": "us-west-1","BucketName":"my-s3-bucket"},"RunConfig": {"Ports" : [80, 443]}}
If you need to specify a specific zone when creating the instance use the Subnet config var.
This is necessary for certain operations such as when you want to mount a volume to an instance.
By default, ops uses the first VPC found in aws and creates a security group per instance.
You can select a different VPC or use a existing security group using the configuration file. The keys to set are RunConfig.VPC and RunConfig.SecurityGroup.
{"RunConfig":{"VPC": "vpc-name","SecurityGroup": "sg-name"}}
You can list instance on AWS using ops instance list command.
$ ops instance list -p prod-1033 -t aws -z us-west-2$ ops instance list+------+----+--------+---------+-------------+------------+| NAME | ID | STATUS | CREATED | PRIVATE IPS | PUBLIC IPS |+------+----+--------+---------+-------------+------------+
Alternatively you can pass project-id and zone with cli options.
$ ops instance list -p prod-1000 -z us-west1-b
You can get logs from serial console of a particular instance using ops instance logs command.
$ ops instance logs <instance_name>
Alternatively you can pass project-id and zone with cli options.
$ ops instance logs -t aws -p prod-1033 -z us-west-2 i-08815dc4b29b44294
ops instance delete command can be used to delete instance on AWS.
$ ops instance delete my-instance-running
Alternatively you can pass project-id and zone with cli options.
$ ops instance delete -p prod-1000 -z us-west1-b my-instance-running
IPV6 support differs from cloud to cloud. On AWS DHCPV6 is used. You can have an ip auto-assigned or you can set one yourself but you must be aware that a subnet must have IPv6 enabled.
A sample config for assigning an ip:
➜ g cat config.json{"CloudConfig" :{"Zone": "us-west-1","BucketName":"my-bucket","EnableIPv6": true,"VPC":"test-ipv6-test-2"},"RunConfig": {"IPv6Address": "2600:1f1c:604:9a00:7a34:8c37:5b08:f104","Ports": ["80","8080","443"]}}
To test:
[[email protected] ~]$ ping6 2600:1f1c:604:9a00:7a34:8c37:5b08:f104PING 2600:1f1c:604:9a00:7a34:8c37:5b08:f104(2600:1f1c:604:9a00:7a34:8c37:5b08:f104) 56 data bytes64 bytes from 2600:1f1c:604:9a00:7a34:8c37:5b08:f104: icmp_seq=1 ttl=255 time=0.573 ms64 bytes from 2600:1f1c:604:9a00:7a34:8c37:5b08:f104: icmp_seq=2 ttl=255 time=0.419 ms^C
Be aware that you might not have IPV6 connectivity from the laptop/server you are testing from. You can verify within an instance on AWS to test connectivity.
When you mount a volume to an AWS instance you must specify the zone modifier for the region. So instead of using:
"Zone": "us-west-1",
Use
"Zone": "us-west-1c",
OPS will strip the zone 'c' from other operations that only require/desire region.
