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:

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ä.

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.

Suositellut käytännöt

• 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