Muistiinpano
Tälle sivulle pääsy edellyttää valtuutusta. Voit yrittää kirjautua sisään tai vaihtaa hakemistoja.
Tälle sivulle pääsy edellyttää valtuutusta. Voit yrittää vaihtaa hakemistoja.
Lue, miten Gitin integrointi- ja käyttöönottoputket toimivat GraphQL:n ohjelmointirajapinnan kanssa Microsoft Fabricissa. Tässä artikkelissa kerrotaan, miten voit määrittää yhteyden säilöösi, hallita GraphQL-ohjelmointirajapintaasi ja ottaa ne käyttöön eri ympäristöissä.
Huomautus
GraphQL-lähdehallinnan ja käyttöönoton ohjelmointirajapinta on tällä hetkellä esikatseluvaiheessa.
Edellytykset
- Sinulla on oltava GraphQL-ohjelmointirajapinta Fabricissa. Lisätietoja on artikkelissa Ohjelmointirajapinnan luominen GraphQL:lle Fabricissa ja tietojen lisääminen.
Yleiskuvaus
Fabric tarjoaa tehokkaita työkaluja CI/CD:hin (jatkuva integrointi ja jatkuva käyttöönotto) ja kehityksen elinkaaren hallintaan kahden pääkomponentin kautta: Git-integroinnin (CI) ja käyttöönottoputket (CD). Työtilat toimivat keskeisinä osina sekä Git-synkronointi- että käyttöönottovaiheissa.
Git-integrointi (CI): Synkronoi työtilan kohteet (esimerkiksi koodi, kokoonpanot, ohjelmointirajapinnat) versiontarkistussäilöihin, mikä mahdollistaa versionhallinnan ja muutosten seurannan Gitin kautta.
Käyttöönottoputket (CD): Mahdollistaa vaiheiden luomisen (esim. kehitys, testi, tuotanto) linkitetyillä työtiloilla. Kussakin vaiheessa tuetut kohteet replikoidaan automaattisesti seuraaviin vaiheisiin ja muutokset työtilan käynnistimen käyttöönotossa julkaisuputkessa. Voit määrittää putken sen varmistamiseksi, että muutokset testataan ja otetaan käyttöön tehokkaasti kaikissa ympäristöissä.
Fabric tukee erilaisia CI/CD-työnkulkuja, jotka on räätälöity yleisiä skenaarioita mukaan. Lisätietoja on artikkelissa CI/CD-työnkulun asetukset Fabricissa.
Huomautus
Vain metatiedot kopioidaan käyttöönoton aikana. ja tietoja ei kopioida.
Työtilan kohteet tallennetaan liittyvään Git-säilöön infrastruktuurina koodina (IaC). Säilön koodin muutokset voivat käynnistää käyttöönoton jaksoissa. Tämän menetelmän avulla koodimuutokset replikoidaan automaattisesti vaiheiden välillä testausta ja tuotannon julkaisua varten.
Tietolähteen todennusmenetelmät
Tässä osiossa tutustut todennusmenetelmiin, joiden avulla voit yhdistää tietolähteitä GraphQL:n ohjelmointirajapintaasi, ja ymmärrät niiden vaikutuksen GraphQL-ohjelmointirajapinnan ja sen yhdistettyjen tietolähteiden väliseen automaattiseen yhdistämiseen kehitysputkissa. Saat lisätietoja automaattisesta sidonnasta käyttöönottoputkiprosessista.
Tietolähteiden yhdistämiseen GraphQL:n ohjelmointirajapintaan on kaksi vaihtoehtoa:
Yhteyden muodostaminen Fabric-tietolähteisiin kertakirjautumisella (SSO)
Yhteyden muodostaminen Fabric OR:n ulkoisiin tietolähteisiin tallennettujen tunnistetietojen avulla
Ensimmäinen vaihtoehto Single Sign-On (SSO) mahdollistaa yhteydet Fabricissa sijaitseviin tietolähteisiin. Tässä tapauksessa, kun yhdistät tietolähteen GraphQL:iin käyttämällä kertakirjautumismenetelmää alkuperäisessä työtilassa (esimerkiksi kehitysvaihe), tietolähde ja GraphQL-kohde otetaan käyttöön kohdetyötilassa (esimerkiksi Testivaihe) putkessa, ja kohdetyötilan GraphQL yhdistetään automaattisesti käytettyyn paikalliseen tietolähteeseen kohdetyötilassa (katso alla oleva kaavio). SSO:n käytössä ja yhteyden muodostamisessa tietolähteeseen SQL Analytics -päätepisteen kautta on erityisiä rajoituksia, katso lisätietoja kohdasta **Nykyiset rajoitukset.
Toinen saved credential -vaihtoehto mahdollistaa yhteydet ulkoisiin tietolähteisiin Fabricin ulkopuolella ja Fabric-tietolähteisiin. Automaattista sidontaa ei kuitenkaan tueta tallennettujen tunnistetietojen tapauksessa. Tämä tarkoittaa sitä, että jos yhdistät tietolähteen GraphQL:iin käyttämällä tallennettua tunnistetietoa alkuperäisessä työtilassa (kehitysvaihe), tietolähde otetaan käyttöön jakson kohdetyötilassa (testivaiheessa). Kohdetyötilan GraphQL-kohde pysyy kuitenkin yhteydessä alkuperäisen työtilan tietolähteeseen (kehitysvaihe) tallennettujen tunnistetietojen kautta sen sijaan, että se sidotaan automaattisesti paikalliseen tietolähteeseen kohdetyötilassa. (katso alla olevaa kaaviota)
Lisäksi jos Tallennettu tunnistetieto -menetelmää käytetään yhteyden muodostamiseen tietolähteisiin, kehittäjien on voitava käyttää tallennettuja tunnistetietoja, jotta GraphQL-kohde voidaan ottaa onnistuneesti käyttöön.
Huomautus
Jos GraphQL:n ohjelmointirajapinta alkuperäisessä työtilassa (kehitysvaihe) on yhdistetty tietolähteeseen, joka on eri työtilassa, kohdetyötilassa (testivaihe) käyttöön otettu GraphQL-ohjelmointirajapinta säilyy yhteydessä tietolähteeseen, joka sijaitsee eri työtilassa riippumatta siitä, mitä todentamismenetelmää käytetään yhdistämään tietolähteet GraphQL:n ohjelmointirajapintaan. (katso alla olevaa kaaviota)
Ohjelmointirajapinta GraphQL Git -integroinnille
Fabric-ohjelmointirajapinta GraphQL:lle tarjoaa Git-integroinnin lähdehallintaan. Gitin integroinnin avulla voit varmuuskopioida ja versioida GraphQL-ohjelmointirajapintasi, palata aiempiin vaiheisiin tarpeen mukaan, tehdä yhteistyötä tai työskennellä yksin Git-haarojen avulla ja hallita GraphQL-elinkaaren ohjelmointirajapintaa kokonaan Fabricissa.
Määritä yhteys:
Työtilan asetuksista voit helposti määrittää yhteyden säilöösi vahvistusta ja muutosten synkronointiaksi. Yhteyden määrittämiseksi katso Git-integroinnin aloittamisen aloittaminen. Kun yhteys on muodostettu, kohteesi, mukaan lukien GraphQL:n ohjelmointirajapinta, näkyvät Lähde-ohjauspaneelissa .
Kun olet onnistuneesti vahvistanut GraphQL-esiintymien ohjelmointirajapinnan Git-säilöön, näet GraphQL-kansiorakenteen säilössä. Voit nyt suorittaa tulevia toimintoja, kuten Luo pull-pyyntö.
GraphQL-esitys Gitissä:
Seuraavassa kuvassa on esimerkki jokaisen GraphQL-kohteen ohjelmointirajapinnan tiedostorakenteesta Git-säilössä:
Kun vahvistat GraphQL-kohteen ohjelmointirajapinnan Git-säilöön, GraphQL-määrityksen ohjelmointirajapinta tallennetaan. Tämä lähestymistapa tukee tarkkaa palautustapaa, kun synkronoit takaisin Fabric-työtilaan:
Lisätietoja GraphQL-ohjelmointirajapinnan määritysmuodosta, syntaksista ja esimerkeistä on Fabric-ohjaustason ohjelmointirajapintojen dokumentaatiossa:
GraphQL:n ohjelmointirajapinta käyttöönottoputkessa
Viimeistele GraphQL-käyttöönoton ohjelmointirajapinta käyttämällä käyttöönottoputkea seuraavien vaiheiden avulla.
Luo uusi käyttöönottoputki tai avaa aiemmin luotu käyttöönottoputki. Lisätietoja on kohdassa Käyttöönottoputkien käytön aloittaminen.
Määritä työtilat eri vaiheisiin käyttöönottotavoittedesi mukaan.
Valitse, tarkastele ja vertaa kohteita, mukaan lukien GraphQL-ohjelmointirajapinta, eri vaiheiden välillä seuraavassa esimerkissä esitetyllä tavalla. Korostetut alueet, jotka ilmaisevat muutettujen kohteiden määrän edellisen vaiheen ja nykyisen vaiheen välillä.
- Valitse kohteet, jotka on otettava käyttöön. Valitse Ota käyttöön , jos haluat ottaa käyttöön valitut kohteet (ohjelmointirajapinta GraphQL:lle ja sen yhdistetylle tietolähteelle) kehitys-, testi- ja tuotantovaiheissa.
Näyttöön tulee seuraava viesti, jossa vahvistetaan kohteet, jotka olet ottamassa käyttöön. Vahvista käyttöönottoprosessi ja jatka sitä valitsemalla Ota käyttöön .
Nykyiset rajoitukset
Ci/CD-kangas ei tue alikohteiden automaattista sidontaa . Tämä tarkoittaa sitä, että jos GraphQL:n ohjelmointirajapinta muodostaa yhteyden SQL Analytics Endpointiin tietolähteen alikohteena alkuperäisessä työtilassa (esimerkiksi kehitysvaihe), historiatietoja ei siilata kohdetyötilaan (esim. testivaihe). Tämän seurauksena GraphQL:lle käyttöön otettu ohjelmointirajapinta kohdetyötilassa (esimerkiksi testivaihe) pysyy yhteydessä SQL Analytics -päätepisteeseen alkuperäisessä työtilassa (esimerkiksi kehitysvaiheessa).
Automaattista sidontaa ei tueta , kun Tallennettu tunnistetieto -menetelmää käytetään tietolähdeyhteyksissä. Lisätietoja on yllä olevassa osassa Tietolähteen todentamismenetelmät .