Määritä resurssit

Bicep-tiedostot ovat tiedostoja, jotka määrittävät käyttöön otettavat Azure-resurssit.

Leluyrityksesi on luotava uudelleenkäytettävä Bicep-tiedosto tuotteen käynnistystä varten. Tiedoston on otettava käyttöön Azure-tallennustili ja Azure-sovelluspalvelun resurssit, joita käytetään kunkin uuden tuotteen markkinoinnissa sen julkaisun aikana.

Tässä osiossa opit määrittämään resurssin Bicep-tiedostossa, miten resurssien nimet toimivat ja miten voit luoda toisiinsa liittyviä resursseja.

Määritä resurssi

Tärkein asia, jonka teet Bicep-tiedostoilla, on Määrittää Azure-resurssisi. Tässä on esimerkki siitä, miltä tyypillinen resurssimääritys näyttää Bicepissä. Tämä esimerkki luo tallennustilin nimeltä toylaunchstorage.

resource storageAccount 'Microsoft.Storage/storageAccounts@2023-05-01' = {
  name: 'toylaunchstorage'
  location: 'westus3'
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
  properties: {
    accessTier: 'Hot'
  }
}

Tutustutaan seuraavaksi tarkemmin joihinkin tämän resurssimäärityksen keskeisiin osiin:

• resource avainsana alussa kertoo Bicepille, että olet määrittämässä resurssin.

• Seuraavaksi annat resurssille symbolisen nimen. Esimerkissä resurssin symbolinen nimi on storageAccount. Bicepissä käytetään symbolisia nimiä resurssiin viittaamiseksi, mutta ne eivät koskaan näy Azuressa.

• Microsoft.Storage/storageAccounts@2022-09-01 on resurssityypin ja -ohjelmointirajapinnan versio resurssin. Microsoft.Storage/storageAccounts kertoo Bicepille, että olet ilmoittamassa Azure-tallennustiliä. Päivämäärä2022-09-01 on Azure-tallennuksen ohjelmointirajapinnan versio, jota Bicep käyttää luodessaan resurssin.

  Vinkki

  Visual Studio Code :n Bicep -laajennus auttaa löytämään luomiesi resurssien resurssityypit ja ohjelmointirajapintaversiot. Jos ARM-mallit ovat sinulle tuttuja, huomaa, että ohjelmointirajapinnan versio vastaa myös käyttämääsi versiota.

• Sinun on määritettävä resurssinimi, joka on nimi, jonka tallennustili määritetään Azuressa. Määrität resurssin nimen avainsanan name.

  Tärkeää

  Symbolisia nimiä käytetään vain Bicep-tiedostossa, eivätkä ne näy Azuressa. Resurssien nimet näkyvät Azuressa.

• Määrität sitten muita tietoja resurssista, kuten sen sijainnin, varastointiyksikön (hinnoittelutason) ja lajin. Voit määrittää myös ominaisuuksia, jotka eroavat eri resurssityypeistä. Myös eri ohjelmointirajapintaversiot saattavat tuoda käyttöön eri ominaisuuksia. Tässä esimerkissä määritämme tallennustilin käyttöoikeustasoksi Hot.

Mitä tapahtuu, kun resurssit riippuvat toisistaan?

Bicep-tiedosto sisältää yleensä useita resursseja. Usein tarvitset resurssin, joka on riippuvainen toisesta resurssista. Voit joutua poimimaan joitakin tietoja yhdestä resurssista, jotta voit määrittää toisen. Jos otat käyttöön verkkosovelluksen, sinun on luotava palvelininfrastruktuuri, ennen kuin voit lisätä sovelluksen siihen. Näitä suhteita kutsutaan riippuvuuksiksi.

Sinun on otettava käyttöön sovelluspalvelusovellus Bicep-tiedostolle, joka auttaa käynnistämään lelutuotteen, mutta jotta voit luoda sovelluspalvelusovelluksen, sinun on ensin luotava sovelluspalvelusopimus. Sovelluspalvelusopimus edustaa palvelimen isännöintiresursseja, ja se esitellään tässä esimerkissä:

resource appServicePlan 'Microsoft.Web/serverFarms@2023-12-01' = {
  name: 'toy-product-launch-plan'
  location: 'westus3'
  sku: {
    name: 'F1'
  }
}

Tämä resurssimääritys kertoo Bicepille, että haluat ottaa käyttöön sovelluspalvelupaketin, jonka resurssityyppi on Microsoft.Web/serverFarms. Suunnitelmaresurssin nimi on toy-product-launch-plan, ja se on otettu käyttöön Länsi-Yhdysvallat 3 -alueella. Se käyttää F1:n hinnoittelu-SKU:a, joka on sovelluspalvelun maksuton taso.

Kun olet nyt määrittänyt sovelluspalvelusuunnitelman, seuraava vaihe on sovelluksen julistaminen:

resource appServiceApp 'Microsoft.Web/sites@2023-12-01' = {
  name: 'toy-product-launch-1'
  location: 'westus3'
  properties: {
    serverFarmId: appServicePlan.id
    httpsOnly: true
  }
}

Tämä Bicep-tiedosto ohjaa Azuren isännöimään sovellusta luomasi palvelupaketin mukaisesti. Huomaa, että palvelupaketin määritelmä sisältää sovelluspalvelusuunnitelman symbolisen nimen tällä rivillä: serverFarmId: appServicePlan.id. Tämä rivi tarkoittaa sitä, että Bicep saa sovelluspalvelusuunnitelman resurssitunnuksen käyttämällä id-ominaisuutta. Käytännössä tämä tarkoita sitä, että tämän sovelluksen palvelinklusterin tunnus on aiemminmääritetyn sovelluspalvelusuunnitelman tunnus.

Kun Azure ilmoittaa sovellusresurssin ominaisuudella, joka viittaa suunnitelman symboliseen nimeen, se ymmärtää, implisiittinen riippuvuus sovelluspalvelusovelluksen ja palvelupaketin välillä. Kun se ottaa resurssit käyttöön, Azure varmistaa, että se ottaa palvelupaketin täysin käyttöön ennen kuin se aloittaa sovelluksen käyttöönoton.