Oman cloud-init-määrityksen käyttäminen VPS:n asennuksessa

Kun asennat VPS:si tai asennat sen uudelleen, voit antaa oman cloud-init-tiedoston. VPS suorittaa tiedoston itse ensimmäisellä käynnistyksellä: se asentaa pakettisi, luo käyttäjäsi ja suorittaa komentosi. Et tarvitse siihen API:a etkä päätettä.

1. Kentän avaaminen

1. Kirjaudu Oma WebOké -palveluun, siirry kohtaan Omat tuotteet ja napsauta VPS:ääsi.
2. Uusi VPS: näet lohkon Asenna VPS:si. Uudelleenasennus: valitse välilehti Lisäasetukset ja napsauta kohdassa Asenna uudelleen painiketta Asenna uudelleen....
3. Valitse käyttöjärjestelmä ja anna root-salasana ja tarvittaessa SSH-avaimesi.
4. Napsauta SSH-avaimen alla Oma cloud-init ja liitä tiedostosi kenttään.
5. Napsauta asennuspainiketta tai Poista kaikki ja asenna uudelleen.

2. Mitä tiedosto saa sisältää?

• Tiedosto, joka alkaa #cloud-config (asetukset YAML-muodossa), tai skripti, joka alkaa #!. Myös #cloud-boothook ja ## template: jinja toimivat.
• Enintään 256 KB ja vain tekstiä (UTF-8).
• YAML:ssa sisennetään välilyönneillä, ei koskaan sarkaimilla.
• WebOké hoitaa verkon (IPv4 ja IPv6). Omaa network-configia ei käytetä.

3. Esimerkki

Tämä tiedosto asentaa paketit htop ja fail2ban, luo käyttäjän anna SSH-avaimella ja sudo-oikeuksilla ja suorittaa sen jälkeen komennon:

#cloud-config
hostname: web1
fqdn: web1.example.com
package_update: true
packages:
  - htop
  - fail2ban
users:
  - default
  - name: anna
    shell: /bin/bash
    sudo: "ALL=(ALL) NOPASSWD:ALL"
    ssh_authorized_keys:
      - ssh-ed25519 AAAAC3Nza... anna@laptop
runcmd:
  - timedatectl set-timezone Europe/Amsterdam

Korvaa avain omalla julkisella avaimellasi. Esimerkki on tarkoitettu Debianille ja Ubuntulle: AlmaLinuxissa ja Rocky Linuxissa asennat paketit htop ja fail2ban runcmd:n kautta komennon dnf install -y epel-release jälkeen.

4. Mikä on etusijalla?

WebOké antaa itse isäntänimen, root-salasanan (tiivisteenä) ja SSH-avaimesi. Tiedostosi yhdistetään niihin. Jos asetat itse kohdat users, password, chpasswd tai ssh_authorized_keys, omasi ovat etusijalla.

5. Onnistumisen tarkistaminen

cloud-init suoritetaan kerran, VPS:n ensimmäisellä käynnistyksellä. Kirjaudu sen jälkeen sisään ja tarkista:

1. cloud-init status --long näyttää status: done, jos kaikki onnistui, tai error ja virheen.
2. Pakettien, komentojen ja skriptien tulosteet ovat tiedostossa /var/log/cloud-init-output.log. Lisätiedot ovat tiedostossa /var/log/cloud-init.log.
3. Komennolla sudo cloud-init schema --system tarkistat tiedostosi. Jos YAML on virheellinen, cloud-init ohittaa osia.

Hyvä tietää

• Toimii kaikilla listan käyttöjärjestelmillä: Ubuntu 24.04 ja 26.04, Debian 12 ja 13, AlmaLinux 9 ja 10 sekä Rocky Linux 9 ja 10.
• Tiedostosi välitetään salattuna, eikä sitä tallenneta VPS:n tehtävähistoriaan. Älä silti lisää siihen salaisuuksia, joita et tarvitse.
• VPS on hallinnoimaton palvelu (unmanaged). Tuki ei auta cloud-init-tiedostosi sisällön kanssa. Kaikki vaihtoehdot löydät osoitteesta docs.cloud-init.io.

Laajempi ohje ja lisää esimerkkejä: Oma cloud-init: VPS:n automaattinen määritys ensimmäisellä käynnistyksellä VPS-oppaassa.

Katso myös: Liitä oma ISO tai asenna VPS uudelleen ja Kirjautuminen VPS:llesi SSH:lla (ja SSH-avaimen luominen).