Ota Fabric-sovellus käyttöön Fabric-sovellukseen

Ota Fabric-sovellus käyttöön Fabric kirjautumalla sisään, ajamalla CLI-käyttöönoton ja tarkistamalla, mitä npx rayfin up konfiguroi sovelluksellesi. Tässä artikkelissa käydään läpi käsitettä siitä, mitä tapahtuu käyttöönoton aikana.

Edellytykset

  • Fabric Apps -projekti, jossa on rayfin/rayfin.yml konfiguraatiotiedosto. Jos sinulla ei vielä ole projektia, katso Create your first Fabric Apps -projekti.
  • Microsoft Entra ID -tili, jolla on pääsy Fabric-työtilaan.

Ota sovelluksesi käyttöön

Suorita seuraava komento projektisi juuresta:

npx rayfin up

Jos et ole kirjautuneena sisään, komentokeskus käynnistää automaattisesti interaktiivisen kirjautumisprosessin.

Mitä käyttöönotto tekee

Komento rayfin up suorittaa seuraavat vaiheet järjestyksessä:

  1. Luo Fabric Apps -kohteen Fabric-työtilassasi (tai käyttää olemassa olevaa uudelleen seuraavilla julkaisuilla).
  2. Hae julkaistavan avaimen etäpalvelusta.
  3. Synkronoi ajonaikaiset asetukset sinun rayfin.yml ja etäpalvelun välillä, mukaan lukien autentikointikonfiguraatiot ja palveluliput.
  4. Soveltaa tietokantaskeemaa, joka on luotu TypeScript-tietomallin koristelijoilta.
  5. Rakentaa ja julkaisee staattisen sisällön, jos staticHosting se on käytössä rayfin.yml—suorittaa build-komennon, pakkaa tuloskansion ZIP-tiedostoon ja lataa sen.
  6. Säilyttää käyttöönoton tiedot rayfin.yml ja .env.fabric-* tiedostot myöhempiä käyttöönottoja varten.

Käyttöönoton jälkeen CLI tulostaa:

  • Isännöinti-URL, jossa sovelluksesi on käytössä
  • Fabric-portaalilinkki käyttöönoton hallintaan
  • Käyttöönoton ID viitteenä

Todentamisen määrittäminen

Vain Fabric välittäjän tunnistautuminen (Entra SSO) on tuettu käyttöönotetuissa sovelluksissa. Sähköposti- ja salasanatunnistus on saatavilla paikallisessa kehityksessä, mutta ei toimi Fabric-käyttöönoton jälkeen.

Varmista, että rayfin.yml on Fabric autentikointi käytössä ennen rayfin up:n suorittamista:

services:
  auth:
    enabled: true
    fabric:
      enabled: true

Esikatselu-käyttöönotto ilman muutoksia

Käytä --dry-run sitä nähdäksesi, mitä komentokeskus tekisi ilman resurssien luomista tai muokkaamista:

npx rayfin up --dry-run

Sovella tietokantamuutoksia

Kun olet päivittänyt tietomallisi, työnnä skeemamuutokset etätietokantaan ilman, että koko pinoa tarvitsee uudelleensijoittaa:

npx rayfin up db apply

Jos skeeman muutos sisältää mahdollisesti tuhoisia operaatioita (sarakkeiden pudottamista, taulukoiden uudelleennimeämistä), komentokeskus varoittaa sinua eikä suostu jatkamaan. Käytä --force turvallisuustarkistuksen ohittamiseen:

npx rayfin up db apply --force

Varoitus

Käyttäminen --force voi aiheuttaa tietojen menetystä. Käy luetellut toiminnot huolellisesti läpi ja varmista, että hyväksyt seuraukset ennen kuin etenet.

Palauta staattinen sisältö

Kun vaihdoit vain frontend-koodia, julkaise staattinen sisältö itsenäisesti nopeamman iterointisyklin saamiseksi:

npx rayfin up staticapp deploy

Tämä komento suorittaa konfiguroidun buildCommand, pakkaa ulostulon ja lataa sen etäpalveluun.

Rakennusvaiheen ohittaminen ja olemassa olevan ulostulon käyttöönotto:

npx rayfin up staticapp deploy --skip-build

Tarkista käyttöönoton tila

Katso Fabric-käyttöönoton nykytila:

npx rayfin up status

Lisää --json koneellisesti luettavaan ulostuloon:

npx rayfin up status --json

Päivitä olemassa olevat käyttöönotot

Ensimmäisen käyttöönoton jälkeen tallennetaan rayfin.yml käyttöönoton tiedot (rayfinItemId, fabricWorkspaceId, ja kohdepäätepiste). Uudelleen ajaminen npx rayfin up päivittää saman käyttöönoton sen sijaan, että luotaisiin uusi.

Kohdennettuja päivityksiä varten käytä alikomentoja:

Komento Mitä se päivittää
npx rayfin up Kaikki: asetukset, tietokanta ja staattinen sisältö.
npx rayfin up db apply Vain tietokantaskeema.
npx rayfin up staticapp deploy Vain staattista sisältöä.

Vianetsintä käyttöönoton ongelmista

Käyttöönotto epäonnistuu 401- tai 403-virheellä

Istuntosi saattoi olla vanhentunut. Aja npx rayfin login uudelleentodennus, sitten yritä npx rayfin upuudelleen.

Tietokannan soveltaminen raportoi tuhoisia muutoksia

Rayfin CLI estää skeeman muutokset, jotka voisivat aiheuttaa tietojen menetystä. Tarkista luetellut toiminnot ja käytä npx rayfin up db apply --force niitä vasta sen jälkeen, kun olet varmistanut hyväksyväsi tietojen menetyksen.

Staattinen käyttöönotto ylittää kokorajan

Pakatun arkiston tilavuus ei saa ylittää 100 MB. Optimoi build-tulos sulkemalla pois lähdekartat ja suuret kehitysassetit, tai siirrä binääritiedostot Fabric Apps -tallennustilaan.

Hallinnoi sovellustasi Fabric-portaalissa

Käyttöönoton jälkeen voit hallita Fabric-sovellustasi suoraan Fabric-portaalissa.

Näytä kohteen ominaisuudet

Avaa Fabric-sovellus Fabric-portaalissa nähdäksesi:

  • Sovelluksen URL — Julkinen URL, jossa staattinen sisältösi isännöidään.
  • App backend URL — Kaikkien backend-palveluiden perusosoite.

Lastensuojelun hallinta

Valitse Fabric-sovellus nähdäksesi sen lastenpalvelut:

  • SQL Database — Avaa Fabric SQL-kyselyeditorin. Voit ajaa lukukyselyitä dataasi vastaan. Skeemamuutokset, jotka tehdään suoraan Fabric-portaalissa, korvataan seuraavassa rayfin up -julkaisussa.
  • Todennus — Katso ja hallinnoi todennoitettuja käyttäjiä Käyttäjät-taulukossa ala-SQL-tietokannassa.

Sovelluksen käyttöoikeudet

Fabric-sovelluksen käyttäjien Fabric-sovelluksen käyttöönottoon tarvitaan vähintään Edit käyttöoikeus kyseiseen kohteeseen.

Liittyvä sisältö

  • Last updated on