Skip to content
This repository was archived by the owner on Jul 9, 2025. It is now read-only.

Commit 1e130c6

Browse files
EC2: Update Libvirt VMM docs
1 parent a03a8c6 commit 1e130c6

File tree

1 file changed

+10
-8
lines changed

1 file changed

+10
-8
lines changed

content/en/user-guide/aws/ec2/index.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -146,7 +146,7 @@ You should see the following output:
146146
```
147147

148148
{{< callout "note" >}}
149-
Similar to the setup in production AWS, the user data content is stored at `/var/lib/cloud/instances/<instance_id>/user-data.txt` within the instance.
149+
Similar to the setup in production AWS, the user data content is stored at `/var/lib/cloud/instances/<instance_id>/` within the instance.
150150
Any execution of this data is recorded in the `/var/log/cloud-init-output.log` file.
151151
{{< /callout >}}
152152

@@ -259,7 +259,7 @@ LocalStack EC2 supports execution of user data scripts when the instance starts.
259259
A shell script can be passed to the `UserData` argument of `RunInstances`.
260260
Alternatively, the user data may also be added using the `ModifyInstanceAttribute` operation.
261261

262-
The user data is placed at `/var/lib/cloud/instances/<InstanceId>/user-data.txt` in the container.
262+
The user data is placed at `/var/lib/cloud/instances/<InstanceId>/` in the container.
263263
The execution log is generated at `/var/log/cloud-init-output.log` in the container.
264264

265265
### Networking
@@ -496,22 +496,23 @@ $ virsh pool-refresh default
496496
Pool default refreshed
497497
</disable-copy>
498498
$ virsh vol-list --pool default
499+
<disable-copy>
499500
Name Path
500501
--------------------------------------------------------------------------------------------------------
501-
502502
ami-1234abcd /var/lib/libvirt/images/ami-1234abcd
503+
</disable-copy>
503504
{{< /command >}}
504505

505506
Only the images that follow the above naming scheme will be recognised by LocalStack as AMIs suitable for launching virtualised instances.
506507
These AMIs will also have the resource tag `ec2_vm_manager:libvirt`.
507508

508509
{{< command >}}
509-
awslocal ec2 describe-images --filters Name=tag:ec2_vm_manager,Values=libvirt
510+
$ awslocal ec2 describe-images --filters Name=tag:ec2_vm_manager,Values=libvirt
510511
{{< /command >}}
511512

512513
### Instances
513514

514-
Virtualised instances can be launched with `RunInstances` operation and specifying a compatible AMI.
515+
Virtualized instances can be launched with `RunInstances` operation and specifying a compatible AMI.
515516
LocalStack will create and start a Libvirt domain to represent the instance.
516517

517518
When instances are launched, LocalStack uses the [NoCloud](https://cloudinit.readthedocs.io/en/latest/reference/datasources/nocloud.html) datasource to customize the virtual machine.
@@ -525,7 +526,8 @@ The Libvirt domains and volumes are left defined and can be used for debugging,
525526
Use [Virtual Machine Manager](https://virt-manager.org/) or [virsh](https://www.libvirt.org/manpages/virsh.html) to manage the virtual machines outside of LocalStack.
526527
{{< /callout >}}
527528

528-
The Libvirt VM manager currently does not support instance user data.
529+
You can pass a shell script as user data when calling `StartInstances`.
530+
The script will be executed when the virtualized instance boots up.
529531

530532
To connect to the graphical display of the instance, first obtain the VNC address using:
531533

@@ -542,8 +544,8 @@ You can then use a compatible VNC client (e.g. [TigerVNC](https://tigervnc.org/)
542544

543545
### Networking
544546

545-
Currently all instances are behind a NAT network.
546-
Instances can access the internet but are inaccessible from the host machine.
547+
All instances are assigned interfaces on the default Libvirt network.
548+
This makes it possible to have host/instance as well as instance/instance network communication.
547549

548550
It is possible to allow network access to the LocalStack container from within the virtualised instance.
549551
This is done by configuring the Docker daemon to use the KVM network.

0 commit comments

Comments
 (0)