Skip to content

fm CLI

fm on Frostmolnin komentorivikäyttöliittymä. Kaiken, mitä voit tehdä portaalissa, voit tehdä myös fm:llä — ihanteellinen skriptaamiseen ja automaatioon.

Asennus

Katso Asennus alustakohtaisia vaiheita varten.

Tunnistaudu

bash
fm auth login

Tämä avaa selaimen sisäänkirjautumista varten ja tallentaa tokenin paikallisesti. Tarkista, kenenä olet kirjautuneena:

bash
fm auth whoami

Selaimettomassa istunnossa tai SSH:n kautta lisää --no-browser, jolloin komento tulostaa vahvistus-URL-osoitteen ja koodin syötettäväksi toisella laitteella.

Automaattista käyttöä varten (CI, skriptit, Terraform-tarjoaja) tunnistaudu API-avaimella selaimella kirjautumisen sijaan. Luo avain portaalissa ja:

bash
fm auth api-key set <your-api-key>

fm lukee tunnuksensa tiedostosta ~/.fm/config.yaml, ei ympäristöstä — API-avaimelle ei ole ympäristömuuttujaa. (Terraform-tarjoaja on se, joka lukee muuttujan FROSTMOLN_API_KEY.)

Komentorakenne

Komennot noudattavat muotoa fm <service> <resource> <action>:

bash
fm compute instance list
fm storage volume create --name data-1 --size 100 --region sweden
fm network vpc list
fm database postgres instance create --version 16 ...

Lisää --help mihin tahansa komentoon nähdäksesi sen liput, ja --output json saadaksesi koneluettavaa tulostetta skriptaamiseen.

Konfiguraatio

fm tallentaa konfiguraationsa (API-päätepiste, alue, API-avain ja oletustulostusmuoto) kotihakemistoosi. Päivitä asetus komennolla:

bash
fm config set <key> <value>

Tenantin valinta

Jos sinulla on pääsy useampaan kuin yhteen tenanttiin, fm toimii oletustenanttisi kanssa, kunnes valitset toisen. Listaa käytettävissä olevat tenantit:

bash
fm tenant list --all

Vaihda aktiivista tenanttia — valinta tallennetaan ja koskee kaikkia seuraavia komentoja:

bash
fm tenant use <tenant-id>

Näytä, mikä tenant on aktiivinen (lisää --output json skriptausta varten):

bash
fm tenant current

Ohita tenant yksittäiselle komennolle globaalilla --tenant-valitsimella tai FM_TENANT-ympäristömuuttujalla:

bash
fm --tenant <tenant-id> compute instance list

Kun useampi on asetettu, tenant valitaan tässä järjestyksessä: --tenant-valitsin, sitten FM_TENANT, sitten fm tenant use -komennolla tallennettu tenant ja lopuksi oletustenanttisi.

Tenantin uudelleennimeäminen

Muuta tenantille näytettävää nimeä. Tarvitset admin- tai owner-roolin tenantin organisaatiossa:

bash
fm tenant rename <tenant-id> --name "Tuotanto"

Vain nimilappu muuttuu. Tenantin tunnus ja sen sisäinen lyhyt nimi säilyvät ennallaan, joten skriptit, Terraform-määrittelyt ja tallennetut tenant-valinnat toimivat edelleen. Nimien ei tarvitse olla uniikkeja.

Aiheeseen liittyvät