Opas: Hallinnoi kehitys- ja tuotantoympäristöjä Rayfin CLI:llä

Tässä tutoriaalissa asetat kahden työtilan elinkaaren Fabric-sovellukselle käyttämällä pelkästään Rayfin CLI:tä. Otat käyttöön ominaisuusmuutokset kehitystyötilassa, validoit ne ja ylennetään sama projekti tuotantotyötilaan. Tämä työnkulku käyttää manuaalisia markkinointivaiheita, joten pysyt hallinnassa siitä, milloin ja miten muutokset tulevat tuotantoon.

Tässä opetusohjelmassa opit:

  • Luo kehittäjä- ja tuotanto-Fabric-työtila samaan projektiin.
  • Ota käyttöön ominaisuusmuutokset dev-työtilassa.
  • Vaihda käyttöönottojen välillä käyttämällä Rayfin CLI:tä.
  • Mainosta validoitua projektia tuotantotilassa.

Edellytykset

  • Fabric-tili
  • Node.js asennettu paikallisesti.
  • Rayfin-komentojärjestelmä on saatavilla kautta npx rayfin. Lisätietoja löytyy Rayfin CLI -viittauksesta.

Yleiskatsaus käyttöönoton kuluun

  1. Aloita paikallisella koneellasi ja luo Fabric-sovellus.
  2. Rakenna ominaisuuksia sovellukseen.
  3. Testaa paikallisesti ja deployeri sitten kehitystyötilassa käyttäen npx rayfin up -workspace <dev-workspace>.
  4. Kun koodin muutokset on testattu hyvin, otetaanpa ne suoraan Production-työtilaan käyttäen npx rayfin up switch -workspace <prod-workspace>. switch mahdollistaa siirtymisen ympäristöjen ja käyttöönottojen välillä.

Kuvakaappaus, joka näyttää käyttöönoton kulun kehitys- ja tuotantoympäristöissä.

Vaihe 1: Luo kehittäjä- ja tuotantotyötilat Fabric:ssa

Luo kaksi työtilaa manuaalisesti Fabric-portaalissa:

  1. Fabric-portaalissa luo työtila nimeltä my-app-dev. Tallenna sen työtilatunnus.
  2. Luo toinen työtila nimeltä my-app-prod. Tallenna sen työtilatunnus.

Vaihe 2: Kirjaudu Fabric-palveluun

Kirjaudu sisään Entra ID -tunnus -tililläsi, jotta CLI voi ottaa käyttöön vuokralaisellesi:

npx rayfin login

Jos haluat kohdistaa tietyn vuokralaisen, läpäise --tenant:

npx rayfin login --tenant <tenant id>

Vahvista kirjautunut tili milloin tahansa:

npx rayfin login status

Vaihe 3: Luo projekti paikallisesti

Rakenna uusi Fabric-sovellus pohjasta. Suorita tämä komento kerran projektille:

npm create @microsoft/rayfin@latest my-app --workspace my-app-dev
cd my-app

Jos lisäät Rayfinin olemassa olevaan projektiin, käytä npx rayfin init sitä sen sijaan.

Vaihe 4: Ota käyttöön dev-työtilassa

Ota sovellus käyttöön projektin rootista my-app-devissä:

npx rayfin up --workspace my-app-dev

Komentokeskus luo Fabric-sovelluksen kohteen dev-työtilassa, soveltaa tietokantaskeemaa ja lataa staattista sisältöä, jos staattinen hosting-järjestelmä on käytössä. Käyttöönotto tallennetaan , rayfin/.envja dev-työtilasta tulee aktiivinen käyttöönotto seuraaville npx rayfin up kutsuille.

Jos haluat esikatsella käyttöönottoa ilman muutoksia, suorita:

npx rayfin up --dry-run --verbose

Vaihe 5: Kehitä ja iteroi kehittäjän työtilaa vastaan

Käytä kehittäjätyötilaa kohteena rakentaessasi ominaisuuksia:

  1. Aja frontend-kehityspalvelin paikallisesti:

    npm run dev

  2. Muokkaa koodiasi, tietomalliasi tai rayfin/rayfin.yml.

  3. Sovella vain skeema-muutoksia tarvittaessa:

    npx rayfin up db apply

  4. Palauta koko sovellus kehitykseen:

    npx rayfin up

Toista tämä silmukka, kunnes ominaisuus on valmis markkinoitavaksi.

Vaihe 6: Yllätä projekti tuotantotilaan

Kun olet valmis julkaisemaan, ota sama projekti käyttöön my-app-prodiin:

npx rayfin up --workspace my-app-prod

Komentokeskus luo erillisen Fabric-sovelluksen tuotteen tuotantotilassa ja tallentaa toisen käyttöönoton. Prodista tulee uusi aktiivinen käyttöönotto, joka rayfin/.env kirjoitetaan uudelleen osoittamaan sitä.

Vaihe 7: Vaihda kehittäjän ja tuotannon käyttöönottojen välillä

Sitä käytetään npx rayfin up switch liikkumiseen kahden tallennetun käyttöönoton välillä ilman, että työtilan ID:t kirjoitetaan uudelleen.

Listaa projektiin tallennetut käyttöönotot:

npx rayfin up list

Valitse sijoituspaikka, johon vaihdat:

npx rayfin up switch --list

Vaihda takaisin kehittäjäksi jatkaaksesi ominaisuustyötä:

npx rayfin up switch my-app-dev

Vaihda tuotantoon hotfix tai validointi varten:

npx rayfin up switch my-app-prod

Vaihdon jälkeen yksinkertaiset npx rayfin up komennot kohdistuvat juuri aktivoituun työtilaan.

Vaihe 8: Validoi tuotannon käyttöönotto

Kun olet ottanut käyttöön tuotantoon, varmista, että käyttöönotto on kunnossa:

npx rayfin up status

Avaa CLI:n tulostama hosting-osoite ja varmista, että sovellus toimii odotetusti. Jos löydät ongelman:

  1. Vaihda takaisin kehittäjäksi:

    npx rayfin up switch my-app-dev

  2. Toista ja korjaa ongelma kehittäjätyötilassa.

  3. Ota käyttöön kehittäjäksi, validoi, vaihda sitten tuotantoon ja käynnistä npx rayfin up vapauta korjaus.

  • Pidä lähdekoodisi versionhallinnassa. Käsittele rayfin/.env sitä paikallisena osoitteena aktiivisesta sijoituksesta, ei totuuden lähteenä.
  • Käytä ominaisuushaaraa keskeneräiseen työhön ja yhdistä päähaaraan vasta, kun kehittäjän käyttöönotto on vahvistettu.
  • Varaa npx rayfin up --force tilanteita, joissa komentokeskus nimenomaisesti suosittelee sitä. Vältä sitä rutiininomaisesti prodia vastaan.
  • Käytä --dry-run ennen minkä tahansalaisen tuotannon käyttöönottoa esikatseluun CLI:n toimien esikatseluun.
  • Vahvista tunnistautumisasetukset rayfin.yml ennen kuin siirrät tuotantoon. Ainoastaan Fabric-välittäjällä toimiva todennus (Entra SSO) on tuettu käyttöönotetuille sovelluksille. Lisätietoja löytyy osoitteesta Deploy a Fabric app to Fabric.

Liittyvä sisältö

  • Rayfin CLI -viittaus
  • Ota käyttöön Fabric-sovellus Fabric
  • Luo ja ota käyttöön ensimmäinen Fabric-sovelluksesi CLI
  • Viimeksi päivitetty