Tunnisteet

Tunniste (tag) on resurssiin liitetty avain=arvo-merkintä, esimerkiksi env=prod tai cost-center=eu-42. Tunnisteilla voit järjestellä ja suodattaa resurssejasi — ympäristön, omistavan tiimin tai kustannuspaikan mukaan.

Tällä sivulla käsitellään:

• resurssin tunnisteet, mukaan lukien Kubernetes-klusterit ja solmupoolit sekä tietokannat, välimuistit, viestinvälittäjät, verkkopalvelimet ja sovellusyhdyskäytävät, sekä VPC-gatewayt ja DNS-tietueet;
• tenantin oletustunnisteet, jotka alusta lisää jokaiseen tenanttiin luotavaan resurssiin;
• tunnisteiden värit, joiden ansiosta tunniste näyttää samalta organisaatiosi kaikissa tenanteissa;
• Terraform: providerin default_tags ja tags_all-attribuutti.

Resurssin tunnisteet

Voit lisätä tunnisteita näihin resursseihin:

• VPC:t, aliverkot ja suojausryhmät
• VPC-gatewayt
• Julkiset IP-osoitteet
• Kuormantasaajat sekä niiden kuuntelijat, poolit, poolien jäsenet ja terveystarkkailijat
• Instanssit, skaalausryhmät ja käynnistysmallit
• Taltiot ja taltioiden tilannevedokset
• Objektitallennuksen bucketit
• DNS-vyöhykkeet ja DNS-tietueet
• Salaisuudet
• Kubernetes-klusterit ja solmupoolit
• Tietokannat, välimuistit, viestinvälittäjät, verkkopalvelimet ja sovellusyhdyskäytävät sekä niiden alle luomasi resurssit (katso alempaa)

Säilörekistereillä ei ole tunnisteita. Instanssien tilannevedokset käyttävät pelkkiä nimikkeitä avain=arvo-tunnisteiden sijaan.

Jokaisella resurssityypillä on omat sääntönsä tunnisteiden avaimille ja arvoille, ja joillakin on tunnisteiden enimmäismäärä. Portaali tarkistaa ne kirjoittaessasi, ja alusta hylkää tunnisteen, joka rikkoo niitä.

Portaali. Lisää tunnisteet luontilomakkeen Tunnisteet-osiossa. Useimpien resurssien tunnisteita voi muokata myöhemmin resurssin sivulla.

fm CLI. Anna --tag key=value (toistettavissa) resurssia luodessasi (salaisuudet käyttävät sen sijaan valitsinta --tags; katso alla), ja lue ja korvaa tunnisteet myöhemmin komennoilla tags get ja tags set:

fm network security-group create --name web --vpc <vpc-id> --tag env=prod --tag team=web
fm network security-group tags get <security-group-id>
fm network security-group tags set <security-group-id> --tag env=prod --tag team=payments
fm network security-group tags set <security-group-id> --clear

tags set korvaa koko joukon: pois jätetty tunniste poistetaan. Poista kaikki tunnisteet valitsimella --clear. Samat tags get- ja tags set-komennot ovat käytettävissä instansseille, taltioille, bucketeille, VPC:ille, julkisille IP-osoitteille, kuormantasaajille sekä niiden pooleille ja terveystarkkailijoille, skaalausryhmille ja käynnistysmalleille. DNS-vyöhykkeillä ja salaisuuksilla ei ole komentoja tags get ja tags set: ne saavat tunnisteet luonnin yhteydessä, ja niitä muutetaan update-komennolla. DNS-vyöhykkeet käyttävät valitsinta --tag (fm dns zone update --tag …, tai --clear-tags kaikkien tunnisteiden poistamiseen). Salaisuudet käyttävät valitsinta --tags, pilkuilla eroteltuna, sekä luonnissa että päivityksessä (fm secrets update --tags …, tai --clear-tags). Katso DNS ja Salaisuudet.

Joissakin resursseissa on myös alustan hallitsemia avaimia, esimerkiksi frostmoln_-alkuisia avaimia. Et voi asettaa niitä. tags get näyttää ne erikseen vain luku -muotoisina, ja alusta säilyttää ne, kun korvaat omat tunnisteesi.

Terraform. Aseta tags-argumentti:

resource "frostmoln_security_group" "web" {
  name   = "web"
  vpc_id = frostmoln_vpc.main.id

  tags = {
    env  = "prod"
    team = "web"
  }
}

Kubernetes-klusterit ja solmupoolit

Hallitulla Kubernetes-klusterilla ja jokaisella sen solmupoolilla on omat tunnisteensa. Tunnisteet ovat omia metatietojasi hakua ja suodatusta varten, ja alusta vain tallentaa ne: ne eivät ole Kubernetes-nimiöitä (labels), eivätkä ne koskaan päädy klusteriin tai sen solmuihin. Solmupoolin labels — Kubernetes-nimiöt, jotka asetetaan poolin jokaiseen solmuun — on erillinen asetus, eikä tunnistesuodatin koskaan osu niihin.

Sääntö	Raja
Tunnisteiden määrä	Enintään 32 klusteria tai solmupoolia kohden, tenantin oletustunnisteet mukaan lukien
Avain	1–64 tavua kirjaimia, numeroita ja merkkejä . _ : / -; alettava ja päätyttävä kirjaimeen tai numeroon
Arvo	Enintään 256 tavua, ilman ohjausmerkkejä. Arvo voi olla tyhjä.
Varatut avainten etuliitteet kirjainkoosta riippumatta	frostmoln_, frostmoln-

Tunnisteiden muuttaminen ei koskaan vaikuta käynnissä olevaan klusteriin tai sen solmuihin.

Ensimmäinen solmupooli saa kopion kerran. Klusterin kanssa luotavalle solmupoolille ei voi antaa omia tunnisteita luontipyynnössä. Sen sijaan se saa kopion klusterin tunnisteista — asettamasi tunnisteet ja tenantin oletustunnisteet — kerran, kun klusteri luodaan. Myöhemmät muutokset klusterin tunnisteisiin eivät päivity siihen; muokkaa poolin omia tunnisteita. Myöhemmin lisättävä solmupooli ei saa kopiota klusterin tunnisteista: anna sille omat tunnisteet, kun lisäät sen. Tenantin oletustunnisteet lisätään siihen kuten jokaiseen uuteen resurssiin.

Portaali. Aseta klusterin tunnisteet luontilomakkeen Tunnisteet-osiossa. Klusterin Yleiskatsaus-välilehdellä Tunnisteet-kortti näyttää ne, ja Muokkaa muuttaa niitä. Solmupoolit-välilehdellä jokainen pooli näyttää tunnisteensa ja sillä on Muokkaa tunnisteita, ja Lisää pooli -lomakkeella on omat tunnisteensa. Suodata klusteriluetteloa tunnisteilla luettelon yläpuolella olevalla tunnistesuodattimella.

fm CLI.

fm kubernetes cluster create --name prod --vpc <vpc-id> --subnet <subnet-id> \
  --node-flavor k8s.gp1.medium --tag env=prod --tag team=platform
fm kubernetes cluster list --tag env=prod
fm kubernetes cluster tags get <cluster-id>
fm kubernetes cluster tags set <cluster-id> --tag env=prod --tag team=payments
fm kubernetes node-pool create <cluster-id> --flavor k8s.gp1.large --name gpu --tag team=ml
fm kubernetes node-pool list <cluster-id> --tag team=ml
fm kubernetes node-pool tags get <cluster-id> <node-pool-id>
fm kubernetes node-pool tags set <cluster-id> <node-pool-id> --clear

tags set korvaa koko joukon, ja --clear poistaa kaikki tunnisteet. list-komennolla suodatat toistamalla --tag-valitsinta: klusteri tai pooli näytetään vain, jos sillä on jokainen antamasi tunniste.

Terraform. frostmoln_kubernetes_cluster ja frostmoln_kubernetes_node_pool ottavat tags-argumentin ja raportoivat tags_all-attribuutin kuten kaikki tunnisteita tukevat resurssit (katso Terraform). Klusterin tags ei hallitse sen ensimmäisen solmupoolin tunnisteita, eikä sitä poolia voi hallita frostmoln_kubernetes_node_pool-resurssina: muuta sen tunnisteita portaalissa tai komennolla fm kubernetes node-pool tags set.

Tietokannat, välimuistit, viestinvälittäjät, verkkopalvelimet ja sovellusyhdyskäytävät

Näillä hallituilla palveluilla on tunnisteet itse palvelussa ja niissä resursseissa, jotka luot sen alle:

Palvelu	Resurssit, joihin voi lisätä tunnisteita
Tietokannat	Instanssit, lukureplikat, varmuuskopiot ja parametriryhmät
Välimuistit	Instanssit ja varmuuskopiot
Viestinvälittäjät	Instanssit
Verkkopalvelimet	Instanssit, verkkotunnukset ja sisällön julkaisut
Sovellusyhdyskäytävä	Yhdyskäytävät, kuuntelijat, reitit, taustapalveluryhmät, taustapalvelut, varmenteet, sallitut reitit, palomuurin sääntöjoukot, niiden julkaistut versiot ja palomuurin testiajot (dry runs)

Samat säännöt pätevät kuin Kubernetes-klustereille: enintään 32 tunnistetta resurssia kohden tenantin oletustunnisteet mukaan lukien; avaimet ovat 1–64 tavua kirjaimia, numeroita ja merkkejä . _ : / -, ja niiden on alettava ja päätyttävä kirjaimeen tai numeroon; arvot ovat enintään 256 tavua ilman ohjausmerkkejä; ja etuliitteet frostmoln_ ja frostmoln- on varattu kirjainkoosta riippumatta.

Tunnisteet ovat omia metatietojasi hakua ja suodatusta varten, ja alusta vain tallentaa ne. Muutos ei koskaan käynnistä, määritä tai julkaise mitään uudelleen: sovellusyhdyskäytävässä tunniste ei ole asetus, joten se ei vaadi käyttöönottoa eikä muuta sitä, mitä yhdyskäytävä palvelee. Jokaisella resurssilla on omat tunnisteensa:

• Lukureplikat saavat niille antamasi tunnisteet sekä tenantin oletustunnisteet. Ne eivät kopioi ensisijaisen instanssin tunnisteita, eikä myöhempi muutos toisella puolella päädy toiselle.
• Palautus luo uuden instanssin. Se saa palautuspyynnössä antamasi tunnisteet sekä tenantin oletustunnisteet. Lähdeinstanssin tunnisteita ei kopioida.
• Itse luomasi varmuuskopiot saavat niille antamasi tunnisteet sekä tenantin oletustunnisteet. Ajastetut varmuuskopiot saavat vain tenantin oletustunnisteet. Ne luetaan kopiosta, joka voi olla enintään 30 sekuntia vanha, ja jos alusta ei pysty lukemaan niitä lainkaan, varmuuskopio otetaan silti ilman tunnisteita. Lisää oletustunnisteet tällaiseen varmuuskopioon jälkikäteen Oletustunnisteet-sivun toiminnolla Käytä olemassa oleviin resursseihin tai komennolla fm tenant default-tags apply.
• Verkkopalvelimen sisällön julkaisu on oma resurssinsa, ja tenantin oletustunnisteet lisätään siihen. Julkaisu ei siksi voi alkaa, kun alusta ei pysty lukemaan tenantin oletustunnisteita: se hylätään virheellä default_tags_unavailable (HTTP 503), ja voit yrittää hetken kuluttua uudelleen.
• Sallittu reitti sovellusyhdyskäytävässä on yhteinen kaikille taustapalveluille, joilla on sama suojausryhmä, protokolla ja portti. Sen tunnisteet asetetaan, kun se luodaan ensimmäisen kerran. Saman reitin salliminen uudelleen käyttää sitä uudelleen ja säilyttää sen tunnisteet.

Sovellusyhdyskäytävän kuuntelijoissa, reiteissä, taustapalveluissa, varmenteissa, sallituissa reiteissä, sääntöjoukkojen versioissa ja testiajoissa tunnisteet ovat ainoa asia, jota voit muuttaa luomisen jälkeen. Muutospyyntö, joka nimeää jonkin muun kentän, hylätään virheellä field_not_updatable.

Portaali. Aseta tunnisteet palvelun luontilomakkeen Tunnisteet-osiossa ja sen resurssien luontidialogeissa (replika, varmuuskopio, palautus, verkkotunnus, julkaisu, kuuntelija, reitti, ryhmä, taustapalvelu, varmenne, sallittu reitti tai sääntöjoukko). Palvelun sivulla on Tunnisteet-kortti ja Muokkaa, ja jokainen resurssi sen välilehdillä ja osioissa näyttää tunnisteensa ja sillä on Muokkaa tunnisteita. Suodata palvelun luetteloa tunnisteiden mukaan luettelon yläpuolella olevalla tunnistesuodattimella.

fm CLI. Jokaisella näistä resursseista tietokantojen parametriryhmiä lukuun ottamatta on tags get ja tags set, ja niiden komennot create ja list ottavat --tag. Käytä fm:n versiota v0.97.0 tai uudempaa. Parametriryhmien tunnisteet asetetaan API:n kautta:

fm database postgres instance create --name orders ... --tag env=prod
fm database postgres instance list --tag env=prod
fm database postgres instance tags set <instance-id> --tag env=prod --tag team=payments
fm database postgres replica tags get <instance-id> <replica-id>
fm database postgres backup tags set <instance-id> <backup-id> --clear
fm cache redis instance tags set <instance-id> --tag env=prod
fm messaging lavinmq instance tags get <instance-id>
fm webserver nginx domain tags set <instance-id> <domain-id> --tag site=shop
fm webserver nginx deploys tags get <instance-id> <deploy-id>
fm appgw tags set <gateway-id> --tag env=prod
fm appgw listener tags set <listener-id> --gateway <gateway-id> --tag team=web

tags set korvaa koko joukon, ja --clear poistaa kaikki tunnisteet. Toista --tag komennolle list suodattaaksesi: resurssi näytetään vain, kun sillä on kaikki antamasi tunnisteet.

Terraform. Nämä resurssit ottavat tags ja raportoivat tags_all, kuten kaikki resurssit, joihin voi lisätä tunnisteita (katso Terraform): frostmoln_postgres_instance, frostmoln_mysql_instance, frostmoln_postgres_read_replica, frostmoln_mysql_read_replica, frostmoln_postgres_backup, frostmoln_mysql_backup, frostmoln_redis_instance, frostmoln_valkey_instance, frostmoln_messaging_instance, frostmoln_apache_instance, frostmoln_nginx_instance, frostmoln_webserver_domain, frostmoln_webserver_deployment, frostmoln_application_gateway, frostmoln_appgw_listener, frostmoln_appgw_route, frostmoln_appgw_backend_pool, frostmoln_appgw_backend, frostmoln_appgw_certificate, frostmoln_appgw_backend_authorization ja frostmoln_appgw_waf_policy. Katso Provider-versiot, mitä provideria ne vaativat.

VPC-gatewayt ja DNS-tietueet

VPC:n gatewaylla ja jokaisella DNS-tietueella on omat tunnisteensa. Niihin pätevät samat säännöt kuin Kubernetes-klustereihin: enintään 32 tunnistetta resurssia kohden tenantin oletustunnisteet mukaan lukien; avaimet ovat 1–64 tavua kirjaimia, numeroita ja merkkejä . _ : / -, ja niiden on alettava ja päätyttävä kirjaimeen tai numeroon; arvot ovat enintään 256 tavua ilman ohjausmerkkejä; ja etuliitteet frostmoln_ ja frostmoln- ovat varattuja kirjainkoosta riippumatta.

Tunnisteet ovat omia metatietojasi hakua ja suodatusta varten, ja alusta vain tallentaa ne. Gatewayn tunnisteiden muuttaminen ei koskaan vaikuta sen osoitteeseen tai VPC:n yhteyksiin, eikä se vaadi vahvistusta. DNS-tietueen tunnisteita ei koskaan julkaista DNS:ssä, eikä pelkkien tunnisteiden muuttaminen muuta vyöhykettä.

Portaali. VPC:n sivulla Gateway-kortissa on tunnisteeditori, kun lisäät gatewayn, ja Gatewayn tunnisteet -kortti näyttää olemassa olevan gatewayn tunnisteet ja muokkaa niitä. DNS-vyöhykkeen sivulla tietueikkunassa on Tunnisteet-osio, tietueluettelo näyttää kunkin tietueen tunnisteet, ja luettelon yläpuolella oleva tunnistesuodatin rajaa sitä.

API. Luontipyynnöt hyväksyvät tags-kentän. Päivityksessä (gatewaylle PATCH, DNS-tietueelle PUT) tags korvaa koko joukon, ja {} poistaa kaikki tunnisteet. Pyyntö, joka sisältää vain tags-kentän, ei muuta mitään muuta. Gatewayluettelo, DNS-tietueluettelo ja reititinluettelo hyväksyvät toistettavan ?tag=key=value-suodattimen: resurssi näytetään vain, jos siinä on kaikki antamasi tunnisteet.

Terraform. frostmoln_gateway ja frostmoln_dns_record hyväksyvät tags-argumentin ja raportoivat tags_all-attribuutin kuten kaikki tunnisteelliset resurssit (katso Terraform). Samoin tekevät kuormantasaajan alaresurssit frostmoln_lb_listener ja frostmoln_lb_member. Katso tarvittava provider kohdasta Provider-versiot.

Olemassa olevat resurssit. Kun tenantin oletustunnisteet lisätään resursseihin, jotka tenantilla jo on (Käytä olemassa oleviin resursseihinOletustunnisteet-sivulla tai fm tenant default-tags apply), VPC-gatewayt ja DNS-tietueet ovat mukana, kun alusta on ottanut nämä tyypit käyttöön. Siihen asti ne saavat tenantin oletustunnisteet vain luotaessa.

Kuormantasaajan poolin jäsenet. Poolin jäsenellä on omat tunnisteensa, ja niihin pätevät samat säännöt kuin kuormantasaajan muihin resursseihin. Aseta ne, kun lisäät jäsenen (portaalissa jäsenen lisäyslomakkeen Tunnisteet-osiossa); tenantin oletustunnisteet lisätään. Muuta niitä myöhemmin jäsenen Muokkaa tunnisteita -toiminnolla tai API:ssa jäsenen PUT-pyynnöllä: tags korvaa koko joukon, ja clearTags: true poistaa kaikki tunnisteet (älä lähetä molempia). Poolin jäsenet ovat mukana, kun tenantin oletustunnisteet lisätään olemassa oleviin resursseihin.

Reitittimet. Reitittimen tunnisteita voi muuttaa luonnin jälkeen API:n kautta: PUT /v1/tenants/{tenant-id}/routers/{router-id} hyväksyy tags-kentän, joka korvaa koko joukon, tai clearTags: true, joka poistaa kaikki tunnisteet.

Tunnisteet käyttöoikeuskäytännöissä

Käyttöoikeuskäytäntöjen ehtoja frn:resourceTag/<k> (katso Ehdot) ei arvioida hallituille palveluille: Kubernetes-klustereille ja solmupooleille, tietokannoille, välimuisteille, viestinvälittäjille, verkkopalvelimille ja sovellusyhdyskäytäville sekä niiden alla oleville resursseille. Tällainen ehto katsotaan tuntemattomaksi, ja tuntematon ehto toimii suljetusti: resurssitunnisteella rajattu allow-sääntö ei koskaan osu, ja resurssitunnisteella rajattu deny-sääntö pätee aina. Älä käytä tunnisteilla rajattuja sääntöjä käyttöoikeuden antamiseen näihin resursseihin.

Tenantin oletustunnisteet

Tenantin oletustunnisteet ovat tunnistejoukko, jonka alusta lisää jokaiseen tenanttiin luotavaan tunnisteita tukevaan resurssiin — riippumatta siitä, kuka resurssin luo: portaali, fm CLI, API tai Terraform. Käytä niitä tunnisteisiin, jotka jokaisella tenantin resurssilla pitää olla, kuten ympäristö tai kustannuspaikka.

Miten oletustunnisteet lisätään

• Ne kopioidaan, kun resurssi luodaan. Sen jälkeen ne ovat resurssin tavallisia tunnisteita. Voit muuttaa tai poistaa niitä kuten muitakin tunnisteita, eikä mikään sido niitä enää tenantin oletustunnisteisiin.
• Resurssin omat tunnisteet voittavat. Oletustunniste lisätään vain, jos luontipyyntö ei itse aseta samaa avainta. Tyhjällä arvolla asetettu avain lasketaan asetetuksi.
• Vain uudet resurssit saavat ne. Oletustunnisteiden muuttaminen ei koskaan muuta jo olemassa olevaa resurssia.
• Muutos tulee voimaan enintään 30 sekunnissa. Resurssi, joka luodaan 30 sekunnin kuluessa muutoksesta, voi vielä saada aiemman joukon.
• Ne lasketaan resurssin tunnisterajaan. Jos oletustunnisteet vievät resurssin yli sen tunnisteiden enimmäismäärän, luonti hylätään. Virhe (tag_limit_exceeded_by_defaults) nimeää oletustunnisteiden avaimet. Poista pyynnöstä joitakin tunnisteita tai pyydä organisaation ylläpitäjää vähentämään tenantin oletustunnisteita. Luontilomakkeessa portaali näyttää, mitkä oletustunnisteet lisätään ja montako omaa tunnistetta voit vielä lisätä.
• Resurssia ei koskaan luoda ilman niitä. Jos alusta ei pysty lukemaan tenantin oletustunnisteita, luonti hylätään virheellä, jonka voi yrittää uudelleen (default_tags_unavailable, HTTP 503). Yritä hetken kuluttua uudelleen.

Skaalausryhmän käynnistämät instanssit saavat tenantin oletustunnisteet sellaisina kuin ne ovat skaalausryhmän skaalautuessa ulos. Käynnistysmallin metadata-kentän (Terraformin metadata-argumentti) avain voittaa oletustunnisteen; mallin omat tunnisteet jäävät mallille eikä niitä kopioida instansseihin. Jos alusta ei uusintayritystenkään jälkeen pysty lukemaan oletustunnisteita, instanssit käynnistetään ilman niitä, jotta skaalaus ei pysähdy.

Oletustunnisteita ei lisätä:

• säilörekistereihin, joilla ei ole tunnisteita (kaikki muut hallitut palvelut ja niiden alle luomasi resurssit saavat ne);
• resursseihin, jotka alusta luo hallitulle palvelulle;
• instanssien tilannevedoksiin, joiden tunnisteet ovat pelkkiä nimikkeitä.

Oletustunnisteiden säännöt

Oletustunniste päätyy kaikentyyppisiin resursseihin, joten kaikkien niiden on hyväksyttävä se. Siksi säännöt ovat tiukemmat kuin yksittäiseen resurssiin asettamillesi tunnisteille.

Sääntö	Raja
Oletustunnisteiden määrä	Enintään 10 tenanttia kohden
Avain	1–64 tavua kirjaimia (a-z, A-Z), numeroita ja merkkejä . _ : -; alettava ja päätyttävä kirjaimeen tai numeroon. Ei /-merkkiä, ei välilyöntejä.
Arvo	0–255 tavua kirjaimia, numeroita, välilyöntejä ja merkkejä + - . _ : / @ =. Arvo voi olla tyhjä.
Varatut avainten etuliitteet, kirjainkoosta riippumatta	frostmoln_, frostmoln-, os_, instance_, nova_
Varatut avaimet, kirjainkoosta riippumatta	request-id, customer-id, project-id, tenant-id, created-at, acl, storage-class, quota-bytes, cors-config

Kuka voi muuttaa niitä

Kuka tahansa tenantin omistavan organisaation jäsen voi lukea sen oletustunnisteet. Niiden muuttaminen edellyttää kyseisessä organisaatiossa ylläpitäjän tai omistajan roolia. API-avain tarvitsee lukemiseen käyttöoikeuden organizations:read ja muuttamiseen organizations:write; katso API-avaimen käyttöoikeudet.

Jokaisella tenantilla on yksi oletustunnistejoukko, joka on tyhjä, kunnes joku asettaa sen. Jokainen muutos korvaa koko joukon, eikä lukitusta ole: viimeisin kirjoitus voittaa, joten hallitse joukkoa yhdestä paikasta.

Oletustunnisteiden asettaminen

Portaali. Avaa tilivalikko (oikeassa yläkulmassa) ja valitse Oletustunnisteet. Sivu näyttää valitsemasi tenantin oletustunnisteet. Ylläpitäjät ja omistajat voivat lisätä, muuttaa ja poistaa tunnisteita ja valita sitten Tallenna; muut jäsenet näkevät luettelon vain luku -muotoisena.

fm CLI. Komennot koskevat aktiivista tenanttia; anna --tenant, jos haluat käsitellä toista.

fm tenant default-tags get
fm tenant default-tags set --tag env=prod --tag cost-center=eu-42
fm tenant default-tags set --tag owner=team-a --merge
fm tenant default-tags clear

set korvaa koko joukon. Valitsimella --merge se sen sijaan lisää tunnisteesi nykyiseen joukkoon. clear pyytää vahvistuksen; anna --yes, kun fm ei ole käynnissä päätteessä.

Terraform. frostmoln_tenant_default_tags-resurssi hallitsee providerin tenantin koko joukkoa:

resource "frostmoln_tenant_default_tags" "this" {
  tags = {
    env         = "prod"
    cost-center = "eu-42"
  }
}

Tämä resurssi omistaa joukon. Jokainen apply kirjoittaa täsmälleen tags-arvon, joten portaalissa lisätty oletustunniste poistetaan seuraavassa applyssa. Resurssin luominen korvaa tenantin nykyisen joukon, ja sen tuhoaminen tyhjentää joukon. Tuo olemassa oleva joukko tenantin tunnisteella: terraform import frostmoln_tenant_default_tags.this <tenant-id>. frostmoln_tenant_default_tags-tietolähde lukee joukon hallitsematta sitä.

Tunnisteiden värit

Tunnisteen värisääntö näyttää tunnisteen valitsemallasi värillä portaalissa ja fm:ssä. Värit asetetaan organisaatiokohtaisesti, ja ne ovat voimassa organisaation kaikissa tenanteissa, joten env=prod näyttää samalta kaikkialla. Ne vaikuttavat vain näkymään: ne eivät muuta resursseissa mitään.

• Sääntö vastaa avainta ja yhtä tarkkaa arvoa (env=prod) tai avainta millä tahansa arvolla (env).
• Tunnisteelle avain=arvo juuri sen arvon sääntö voittaa avaimen mikä-tahansa-arvo-säännön.
• Tyhjän arvon sääntö on eri sääntö kuin mikä-tahansa-arvo-sääntö: se vastaa vain tunnisteita, joiden arvo on tyhjä.
• Avaimet ja arvot vertaillaan kirjainkoon huomioiden.
• Väri on tunnisteen tausta muodossa #RRGGBB. Teksti on musta tai valkoinen sen mukaan, kumpi erottuu paremmin. Tunnisteen teksti näytetään aina, joten väri ei koskaan ole ainoa vihje.

Sääntö	Raja
Säännöt	Enintään 200 organisaatiota kohden ja yksi kutakin avainta ja arvoa kohden
Avain	1–255 merkkiä, ei ohjaus- tai muotoilumerkkejä
Arvo	Enintään 256 merkkiä, ei ohjaus- tai muotoilumerkkejä; tai ei arvoa, jolloin sääntö vastaa mitä tahansa arvoa
Varatut avainten etuliitteet	frostmoln_ ja frostmoln-, vain pienillä kirjaimilla: avaimen kuten Frostmoln_Team voi värittää
Väri	#RRGGBB, esimerkiksi #1f6feb

Kuka tahansa organisaation jäsen voi lukea sen värisäännöt. Niiden lisääminen, muuttaminen ja poistaminen edellyttää ylläpitäjän tai omistajan roolia. API-avain tarvitsee lukemiseen käyttöoikeuden organizations:read ja muuttamiseen organizations:write.

Portaali. Siirry kohtaan Organisaatiot, avaa organisaatiosi ja valitse Asetukset-välilehti. Valitse Tunnisteiden värit -kortissa Lisää väri, anna tunnisteen avain, valitse sitten joko Mikä tahansa arvo tai anna arvo, ja valitse väri värinvalitsimella tai kirjoita se heksamuodossa. Jäsenet, jotka eivät ole ylläpitäjiä tai omistajia, näkevät luettelon vain luku -muotoisena.

fm CLI. fm organization tag-colors käsittelee organisaatiota, joka omistaa aktiivisen tenanttisi; anna --organization, jos haluat käsitellä toista. Täsmälleen toinen valitsimista --value ja --any-value vaaditaan. Laita väri lainausmerkkeihin, koska lainaamaton # aloittaa komentotulkin kommentin, tai jätä # pois.

fm organization tag-colors list
fm organization tag-colors set --key env --value prod --color '#d73a49'
fm organization tag-colors set --key team --any-value --color 1f6feb
fm organization tag-colors delete --key env --value prod

Kun ajat set-komennon uudelleen samalle avaimelle ja arvolle, säännön väri muuttuu. 24-bittisiä värejä tukevassa päätteessä fm näyttää myös tunnisteet niiden väreillä. Se näyttää tunnisteet ilman värejä valitsimella --no-color tai NO_COLOR-muuttujalla sekä silloin, kun tuloste ei mene päätteeseen.

Terraform. Jokainen frostmoln_tag_color-resurssi hallitsee yhtä sääntöä. Jätä value pois, kun haluat säännön vastaavan mitä tahansa arvoa. Ilman organization_id-arvoa sääntö luodaan organisaatioon, joka omistaa providerin tenantin.

resource "frostmoln_tag_color" "prod" {
  key   = "env"
  value = "prod"
  color = "#d73a49"
}

resource "frostmoln_tag_color" "team" {
  key   = "team"
  color = "#1f6feb"
}

frostmoln_tag_colors-tietolähde luettelee organisaation säännöt sekä tunnisteet (id), joita tarvitset portaalissa luodun säännön tuomiseen.

Terraform: default_tags ja tags_all

Providerin default_tags-lohko lisää tunnisteet jokaiseen tunnisteita tukevaan resurssiin, jota tämä provider-konfiguraatio hallitsee:

provider "frostmoln" {
  default_tags {
    tags = {
      managed-by = "terraform"
      env        = "prod"
    }
  }
}

resource "frostmoln_vpc" "app" {
  name = "app"
  cidr = "10.1.0.0/16"

  tags = {
    env = "staging" # resurssin tunniste voittaa samannimisen oletuksen
  }

  # Luo VPC vasta, kun tenantin oletustunnisteet on asetettu.
  depends_on = [frostmoln_tenant_default_tags.this]
}

output "app_vpc_tags" {
  value = frostmoln_vpc.app.tags_all
}

Jokaisella tunnisteita tukevalla resurssilla on kaksi tunnisteattribuuttia:

• tags sisältää täsmälleen sen, mitä resurssin konfiguraatio asettaa.
• tags_all on vain luku -attribuutti, joka sisältää resurssin kaikki tunnisteet: providerin default_tags, resurssin omat tags, tenantin oletustunnisteet ja kaiken Terraformin ulkopuolella asetetun. Viittaa tags_all-attribuuttiin, kun tarvitset koko joukon.

Terraformin ulkopuolella — portaalissa, fm:llä tai tenantin oletustunnisteiden kautta — asetetut avaimet näkyvät vain tags_all-attribuutissa, ja provider säilyttää ne jokaisessa applyssa. Se poistaa vain hallitsemansa avaimet: resurssin tags-arvossa olevat ja ne, jotka se lisäsi default_tags-lohkosta.

Kun sama avain tulee useasta paikasta, tarkin voittaa:

Lähde	Etusija
Resurssin tags	Korkein
Providerin default_tags	Keskitaso
Tenantin oletustunnisteet	Matalin

Providerin default_tags ja tenantin oletustunnisteet eroavat laajuudeltaan ja ajoitukseltaan:

	Tenantin oletustunnisteet	Providerin default_tags
Koskee	Jokaista tenanttiin luotavaa resurssia asiakasohjelmasta riippumatta	Resursseja, joita yksi provider-konfiguraatio hallitsee
Milloin	Kerran, kun resurssi luodaan	Jokaisessa luonnissa ja päivityksessä
Kun niitä muutetaan	Vaikuttaa vain myöhemmin luotaviin resursseihin	Suunnittelee paikallaan tehtävän päivityksen jokaiselle konfiguraation tunnisteita tukevalle resurssille
Näkyy Terraformissa	Vain tags_all-attribuutissa	tags_all-attribuutissa
Säännöt	Oletustunnisteiden säännöt	Samat säännöt, tarkistetaan kun provider konfiguroidaan

default_tags-lohkon muuttaminen päivittää jokaisen tunnisteita tukevan resurssin, jota provider hallitsee. Mitään ei korvata, mutta tarkista suunnitelman koko ennen kuin sovellat sitä suureen konfiguraatioon.

Myös tilannevedokset päivitetään paikallaan, mutta alusta hylkää tilannevedoksen tunnisteiden päivityksen (HTTP 409), kun tilannevedos ei ole tilassa available (sitä otetaan vielä tai sitä palautetaan; aja apply uudelleen, kun se on), sekä joissakin vanhemmissa tilannevedoksissa, joilla ei ole omistajatunnistetta. Hallitse tällaista tilannevedosta toisella, aliasoidulla provider-konfiguraatiolla ilman default_tags-lohkoa ja jätä sen tags ennalleen, tai ota uusi tilannevedos sen tilalle.

Provider-versiot

Käyttökohde	Tarvittava provider
Terraform tenantissa, jolla on oletustunnisteita	v0.62.0 tai uudempi
default_tags ja tags_all	v0.62.0 tai uudempi
frostmoln_tag_color ja frostmoln_tag_colors-tietolähde	v0.63.0 tai uudempi
frostmoln_tenant_default_tags (resurssi ja tietolähde)	v0.65.0 tai uudempi
tags resursseissa frostmoln_kubernetes_cluster ja frostmoln_kubernetes_node_pool	v0.81.0 tai uudempi
tags tietokantojen, välimuistien, viestinvälittäjien, verkkopalvelimien ja sovellusyhdyskäytävien resursseissa	v0.82.0 tai uudempi
tags resursseissa frostmoln_gateway, frostmoln_dns_record, frostmoln_lb_listener ja frostmoln_lb_member	v0.83.0 tai uudempi

Kun tenantilla on oletustunnisteita, vanhemmat providerit epäonnistuvat luodessaan siihen tunnisteita tukevan resurssin virheellä "Provider produced inconsistent result after apply": resurssi palaa tunnisteilla, joita ne eivät odottaneet. Päivitä provider ennen kuin asetat oletustunnisteita tenantille, jota hallitaan Terraformilla.

Päivitys versiosta, jossa ei ole tags_all-attribuuttia, muuttaa yhtä toimintaa: konfiguraation ulkopuolella asetettu avain näkyi aiemmin tags-erona, jonka seuraava apply poisti. Nyt se säilyy, tags_all-attribuutissa.

Siirtyminen toisesta pilvestä

Kun muunnat konfiguraation komennolla fm terraform convert, AWS-providerin default_tags ja Google-providerin default_labels muuttuvat Frostmoln-providerin default_tags-lohkoksi. Azure-providerilla ei ole provider-tason oletustunnisteita. Mitään ei muunneta tenantin oletustunnisteiksi, eikä millään lähdepilvellä ole tunnisteiden värejä. Katso lisätiedot AWS-, Azure- ja Google Cloud -matriiseista.

Liittyvät

• API-avaimen käyttöoikeudet · Pilvimigraatio
• fm CLI -referenssi: fm organization · fm tenant
• Terraform: frostmoln_tag_color · tietolähde frostmoln_tag_colors