From bdf58f520e13138b415245735ae6840c795ed412 Mon Sep 17 00:00:00 2001 From: ghe0 Date: Mon, 17 Feb 2025 18:33:49 +0200 Subject: [PATCH] improve advanced vm configuration docs --- src/cloud/advanced.md | 35 ++++++++++++++++++++++++++++++++++- 1 file changed, 34 insertions(+), 1 deletion(-) diff --git a/src/cloud/advanced.md b/src/cloud/advanced.md index c100e33..b1fd390 100644 --- a/src/cloud/advanced.md +++ b/src/cloud/advanced.md @@ -2,6 +2,39 @@ This page is oriented towards power users that would like to know more about the mechanics of the DeTEE platform and would like to experiment by adding their own kernel, their own initrd or building OS templates for their own distribution or with their own apps. +## Add IPv6 to VM + +As long as the node operator offered an IPv6 range on his node, you will be able to deploy a VM with IPv6 support. This was not added to the predefined list of parameters for the CLI, however you can deploy using the `--from-yaml` flag, that allows you to add IPv6 support. More examples can be found in `/root/.detee/samples/`. + +To test this out, run: +``` +detee-cli vm deploy --from-yaml /root/.detee/samples/new_vm/public_ipv4_and_ipv6.from-yaml +``` + +After that, SSH into the VM and test IPv6 connectivity. Example: +``` +root@24ddd97f135b /# detee-cli vm deploy --from-yaml /root/.detee/samples/new_vm/public_ipv4_and_ipv6.yaml +Node price: 0.00002/unit/minute. Total Units for hardware requested: 43. Locking 0.258 LP (offering the VM for 5 hours). +Injecting disk encryption key into VM. This will take a minute. Do not interrupt. +VM CREATED! To ssh, run the following command: + ssh -p 22 root@173.234.136.154 +root@24ddd97f135b /# ssh -p 22 root@173.234.136.154 +[root@my-public-vm-01 ~]# ip -c -br a +lo UNKNOWN 127.0.0.1/8 ::1/128 +enp0s1 UP 173.234.136.154/27 2a0d:3003:b666:a00c:2::11/64 fe80::fcc8:b0ff:fe12:c285/64 +[root@my-public-vm-01 ~]# ping 2606:4700:4700::1111 +PING 2606:4700:4700::1111 (2606:4700:4700::1111) 56 data bytes +64 bytes from 2606:4700:4700::1111: icmp_seq=1 ttl=57 time=14.9 ms +64 bytes from 2606:4700:4700::1111: icmp_seq=2 ttl=57 time=13.4 ms +64 bytes from 2606:4700:4700::1111: icmp_seq=3 ttl=57 time=14.3 ms +64 bytes from 2606:4700:4700::1111: icmp_seq=4 ttl=57 time=13.1 ms +^C +--- 2606:4700:4700::1111 ping statistics --- +4 packets transmitted, 4 received, 0% packet loss, time 3005ms +rtt min/avg/max/mdev = 13.136/13.931/14.892/0.697 ms +[root@my-public-vm-01 ~]# +``` + ## Kernel and DTRFS DeTEE VMs currently run using the latest stable version of the kernel. This is required in order to guarantee that the SNP features are enabled. As the progress moves forward, we will also offer the LTS kernel as part of our default feature set. @@ -106,7 +139,7 @@ Logout of SSH and scp `/tmp/os_template.fsa` to your machine: ## Experimenting on your own -If you feel like experimenting, the CLI allows you to deploy a VM using your own kernel and your own OS template. This can be done using `detee-cli vm deploy --from-yaml` and passing the path to your config. Examples can be found in `~/.detee/cli/new_vm_samples/` +If you feel like experimenting, the CLI allows you to deploy a VM using your own kernel and your own OS template. This can be done using `detee-cli vm deploy --from-yaml` and passing the path to your config. Examples can be found in `~/.detee/samples/new_vm/` This is how the yaml file must look: ```yaml