SmartOS provides the ability to inject cloud-init data into a zone/VM. This is extremely useful for automating some of the menial tasks one would normally have to perform manually like setting up users, installing packages, or pulling down a git repo. Basically, anything you can stuff into cloud-init user-data is at your disposal.
However, since SmartOS zone definitions are in JSON and cloud-init data is in yaml, it’s not immediately obvious how to supply this information. What it boils down to is, escape all double-quotes (“) and line-feeds.
Here’s our cloud-init config which creates a new user and import their ssh key from launchpad.net.
#cloud-config
users:
- default
- name: shaner
ssh_import_id: shaner
lock_passwd: false
sudo: "ALL=(ALL) NOPASSWD:ALL"
shell: /bin/bash
So following the above escape rules above, here’s our full SmartOS zone spec, including the cloud-init data. Note the cloud-init:user-data key.
{
"brand": "kvm",
"alias": "ubuntu-xenial",
"ram": "2048",
"vcpus": "2",
"resolvers": [
"192.168.1.1",
"1.1.1.1"
],
"nics": [
{
"nic_tag": "admin",
"ip": "192.168.1.50",
"netmask": "255.255.255.0",
"gateway": "192.168.1.1",
"model": "virtio",
"primary": true
}
],
"disks": [
{
"image_uuid": "429bf9f2-bb55-4c6f-97eb-046fa905dd03",
"boot": true,
"model": "virtio"
}
],
"customer_metadata": {
"cloud-init:user-data": "#cloud-config\n\nusers:\n - default\n - name: shaner\n ssh_import_id: shaner\n lock_passwd: false\n sudo: \"ALL=(ALL) NOPASSWD:ALL\"\n shell: /bin/bash"
}
}
Let’s go ahead and create the zone on our SmartOS box.
[root@vmm01 /opt/templates]# vmadm create < ubuntu-xenial.json
Successfully created VM 0e908925-600a-4365-f161-b3a51467dc08
[root@vmm01 /opt/templates]# vmadm list
UUID TYPE RAM STATE ALIAS
0e908925-600a-4365-f161-b3a51467dc08 KVM 2048 running ubuntu-xenial
After a bit of time, we can try logging in as our new user we requested. Recall, we asked cloud-init to pull in our public ssh key from launchpad so, if you get prompted for a password, something is wrong.
shaner@tp25:~$ ssh 192.168.1.50
The authenticity of host '192.168.1.50 (192.168.1.50)' can't be established.
ECDSA key fingerprint is SHA256:hFPjwUJjd7N/Gb9EE37fTVt2Lk6NVzoLKvhFN7wYw2M.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '192.168.1.50' (ECDSA) to the list of known hosts.
Welcome to Ubuntu 16.04.3 LTS (GNU/Linux 4.4.0-116-generic x86_64)
Certified Ubuntu Cloud Image
__ . .
_| |_ | .-. . . .-. :--. |-
|_ _| ;| || |(.-' | | |
|__| `--' `-' `;-| `-' ' ' `-'
/ ; Instance (Ubuntu 16.04.3 LTS 20180222)
`-' https://docs.joyent.com/images/linux/ubuntu-certified
http://www.ubuntu.com/cloud#joyent
* Documentation: https://help.ubuntu.com
* Management: https://landscape.canonical.com
* Support: https://ubuntu.com/advantage
Get cloud support with Ubuntu Advantage Cloud Guest:
http://www.ubuntu.com/business/services/cloud
0 packages can be updated.
0 updates are security updates.
The programs included with the Ubuntu system are free software;
the exact distribution terms for each program are described in the
individual files in /usr/share/doc/*/copyright.
Ubuntu comes with ABSOLUTELY NO WARRANTY, to the extent permitted by
applicable law.
shaner@0b8d7a26-ffe4-e859-eb56-d96d02bf213e:~$ sudo ls
shaner@0b8d7a26-ffe4-e859-eb56-d96d02bf213e:~$ sudo apt-update && sudo apt-upgrade -y
There’s a LOT you can do with cloud-init data. See the below links for more info.
Cloud-init examples: https://cloudinit.readthedocs.io/en/latest/topics/examples.html
Joyent Datasource: https://github.com/number5/cloud-init/blob/master/cloudinit/sources/DataSourceSmartOS.py
Joyent Ubuntu Image documentation: https://docs.joyent.com/public-cloud/instances/virtual-machines/images/linux/ubuntu-certified
