An EZGH Optimized image is a stock image with EZGH’s guest agents already
installed and enabled. linux/ezgh-ubuntu:24.04 is the same Ubuntu as linux/ubuntu:24.04, with
the same login user and nothing else changed.
| Image | Alias | Built from | Login user |
|---|---|---|---|
| Ubuntu 26.04 LTS (EZGH Optimized) | linux/ezgh-ubuntu:26.04 |
linux/ubuntu:26.04 |
ubuntu |
| Ubuntu 24.04 LTS (EZGH Optimized) | linux/ezgh-ubuntu:24.04 |
linux/ubuntu:24.04 |
ubuntu |
| Debian 13 (EZGH Optimized) | linux/ezgh-debian:13 |
linux/debian:13 |
debian |
| Debian 12 (EZGH Optimized) | linux/ezgh-debian:12 |
linux/debian:12 |
debian |
| Rocky Linux 10 (EZGH Optimized) | linux/ezgh-rocky:10 |
linux/rocky:10 |
rocky |
| Rocky Linux 9 (EZGH Optimized) | linux/ezgh-rocky:9 |
linux/rocky:9 |
rocky |
There’s no optimized Alpine image: the agents need systemd. All are amd64.
Launch one by its alias, like any image:
ezgh compute instances launch web-1 --instance-type <type> --root-volume-type <volume type> \
--image linux/ezgh-ubuntu:24.04 --ssh-key laptop --ipv4 --waitThe image carries no credentials. The agents start idle and do nothing until you give them access, as below.
What’s on the image
| Component | What it does | Images |
|---|---|---|
qemu-guest-agent |
For the platform’s own use, such as shutting the instance down cleanly; nothing to configure | All |
ezgh-fleets-agent |
Registers the instance as a Fleets node, for shell sessions and run command without SSH keys | All |
ezgh-obs-agent-linux |
Sends the guest’s own metrics and journald logs to Observability | All |
ezgh-vpc-addresses |
Configures the instance’s secondary private addresses from the metadata service | Ubuntu and Debian |
Fleets agent
The agent is configured to take keys for the instance’s bot from the
metadata service. Attach a bot with the Fleets node permissions, fleets.nodes.register and
fleets.nodes.connect, and the instance registers as a node, linked to the instance and named
after it. Install the agent has the exact policy and
why a node bot should have nothing else. Until a bot is attached, the agent checks again every few
minutes, so attaching one later is enough; there’s nothing to install or run on the instance.
Observability agent
The agent is installed and enabled, set to send CPU, memory, disk, filesystem and network metrics
every 30 seconds and the system journal, to the project’s production environment. It sends with
keys for the instance’s bot, so no key is stored on the disk.
Attach a bot with the ObsIngestAccess managed policy:
ezgh iam bots create instance-telemetry
ezgh iam policies attach ObsIngestAccess --bot instance-telemetry
ezgh compute instances update web-1 --bot bot_...Until a bot is attached, the agent sends nothing and checks again every few minutes, so attaching
one later is enough. While the bot isn’t allowed to send, the agent drops what it collects instead
of storing it. During a network outage it stores data on the disk, within limits, and sends it
afterwards. The instance needs a route to obs-ingest.ezghcloud.com over IPv6 or IPv4.
Instances launched before this was available keep the agent they have, set up with an ingest key.
To change what it collects, edit /etc/ezgh-obs-agent-linux/config.yaml and run
sudo systemctl restart ezgh-obs-agent-linux.
VPC addresses hook
On Ubuntu and Debian images, the ezgh-vpc-addresses
hook is already installed and enabled. It configures the
secondary private addresses each private
interface owns, as reported by the metadata service. On an instance without a private interface it
does nothing. The instance’s boot-time install still checks it at every boot and keeps it at the
version EZGH Compute pins; the copy on the image only saves the download.
Rocky images don’t carry the hook. It isn’t supported on Rocky, with or without an optimized image.
Turn a component off
Each is an ordinary systemd unit. To turn one off on an instance:
sudo systemctl disable --now ezgh-fleets-agent
sudo systemctl disable --now ezgh-obs-agent-linux
sudo systemctl disable --now ezgh-vpc-addresses.timer ezgh-vpc-addresses.serviceHow the images are updated
Each optimized image is rebuilt whenever the stock image it’s built from moves to a new release, and whenever what goes on it changes. Every new image is booted and checked before its alias moves to it. As with any alias, a launch uses the image the alias names at that moment, and existing instances aren’t changed.
ezgh compute images get linux/ezgh-ubuntu:24.04 shows the image the alias names now.
ezgh compute images get <img_…> -o json shows where that image came from in its provenance:
kindisbuilt, rather than the stock images’upstream.sourceUrlis the stock image’s source, the distribution’s cloud image.upstreamSerialis<stock serial>-<build revision>: the stock image it was built from, and the revision of what was installed on it.