Utviklingsprosess ved bruk av branch workspace

Branch workspace er et arbeidsområde som er koblet til et kildearbeidsområde. Det lar utviklere jobbe med endringer i et isolert miljø, forstå hvordan arbeidet deres relaterer seg til andre arbeidsområder, og fremme endringer tilbake til hovedarbeidsplassen med selvtillit.

Forholdet (linken) mellom et forgreningsarbeidsområde og dets kildearbeidsområde etableres når brukeren utfører forgrening. For Fabric-utviklere oppretter forgrening en ny Git-gren fra kildearbeidsområdets tilknyttede gren. Brukeren kan velge enten å opprette et nytt arbeidsområde koblet til en ny opprettet gren, eller bruke et eksisterende arbeidsområde ved å bytte dens Git-gren til den nyopprettede.

Notat

Hvis du setter opp en automatiseringsflyt som utfører de samme handlingene som branch-out, bruk forhåndsvisningen Create Workspace Relation API for å opprette branch workspace-relasjonen. Kall dette API-et etter at flyten har forberedt grenarbeidsområdet, opprettet Git-grenen og konfigurert arbeidsområdets Git-tilkobling.

Filialarbeidsområde

Forholdet mellom grenarbeidsområdet har flere visuelle representasjoner i Fabric-grensesnittet:

  • Arbeidsområdetre: Representerer kildearbeidsområdet som forelderen til grenarbeidsområdet

    Skjermbilde av arbeidsområdets trehierarki med grenarbeidsområder.

  • Arbeidsområde-breadcrumbs: Navigasjonsvalg fra grenarbeidsområde til kildearbeidsområde

    Skjermbilde av breadcrumbs fra en grenarbeidsplass.

  • Fanen Kildekontroll – relaterte greiner

    Skjermbilde av branch-workspace-relaterte grener.

Forgreningsoperasjon

Som standard, når en branch-out-operasjon fullføres, inkluderes alle elementer fra kilde-grenen i målarbeidsområdet. Denne oppførselen kan endres ved å velge utvalgte elementer individuelt under branch-out-oppsettet, slik at kun valgte elementer kan inkluderes i målarbeidsområdet for raskere kodetid.

Som Fabric-utvikler vil forgreningsflyten være som følger:

  1. I Kildekontrollpanelet , velg Branch out.

    Skjermbilde av alternativet for utgrening av kildekontroll.

  2. Spesifiser om du vil opprette et nytt arbeidsområde eller forgrene deg til et eksisterende. Skriv inn navnene på den nye grenen og arbeidsområdet, eller velg det eksisterende arbeidsområdet fra nedtrekkslisten. Hvis du velger å forgrene deg til nytt arbeidsområde, kan du kanskje slå på/av Brukergren-arbeidsområdets admin-profil (Forhåndsvisning)

Notat

Alternativet for branch workspace admin-profil (Forhåndsvisning) er kun tilgjengelig når en workspace-administrator har konfigurert en profil. Når du forgrener deg fra et eksisterende grenarbeidsområde, er dette alternativet kun tilgjengelig hvis foreldrearbeidsområdet har en grenarbeidsområde-adminprofil konfigurert. For mer informasjon, se Konfigurer profiler for grenarbeidsområder (Forhåndsvisning).

Før branch-out begynner, validerer Fabric om identiteten din kan fullføre operasjonen. Hvis valideringen feiler, viser Fabric en feil og forhindrer at operasjonen starter. Du må kanskje bruke den konfigurerte admin-profilen for å fortsette, eller gå videre til et eksisterende arbeidsområde i stedet. Denne tidlige valideringen forhindrer en operasjon som ellers ville feilet.

  1. Sjekk Select-elementene individuelt i tilfelle du vil jobbe kun med delmengden av elementene i branch-arbeidsområdet. Du vil se følgende skjermbilde når du oppretter et nytt arbeidsområde med selektiv forgrening.

Viktig!

Når du utvider til et eksisterende arbeidsområde, kan elementer som ikke lagres i Git bli slettet. Forplikt deg til alle gjenstander du vil beholde før du fortsetter. Du må bekrefte at du forstår denne risikoen før du starter forgreningsoperasjonen.

Skjermbilde av utvalgte gjenstander enkeltvis.

  1. Klikk på Branch out-knappen (steg 5-9 gjelder kun når Selected items er valgt individuelt )

  2. Denne handlingen åpner en dialogboks for å velge elementer til arbeidsområdet ditt.

  3. Velg elementene du ønsker til dette arbeidsområdet.

  4. Klikk på Lag gren.

    Skjermbilde av create branch.

  5. Når du utfører selektiv forgrening, kreves alle elementenes avhengigheter. Du kan bruke knappen for å velge relaterte gjenstander til det formålet. Hvis du ikke velger en av avhengighetene, ser du følgende: Skjermbilde av avhengighetsfeil.

    Notat

    Du kan velge gjenstander og starte utvidelse mens Fabric regner ut avhengighetene deres i bakgrunnen. Men å fortsette før alle relaterte elementer er lastet inn, kan føre til at operasjonen mislykkes.

  6. Når grenen er opprettet, kan du verifisere at du er i en selektiv gren ved å bruke ikonet nederst i statuslinjen (nederst til venstre). Det står selektiv gren. Skjermbilde av valgt gren-ikon.

  7. Fabric lager det nye kontorområdet i grenen. Du blir automatisk tatt med til det nye arbeidsområdet. Den inneholder alle gjenstander eller bare de du valgte i tilfelle selektiv forgrening.

Arbeidsområdet synkroniseres med funksjonsgrenen din, og blir et isolert miljø å jobbe i, som illustrert nedenfor. Du kan nå jobbe i dette nye filialarbeidsområdet. Synkroniseringen kan ta noen minutter. Hvis du vil ha mer informasjon om hvordan du forgrener deg, kan du se tips for feilsøking.

Diagram som viser arbeidsflyten for utføringer.

  1. Lagre endringene, og utfør dem i funksjonsgrenen.
  2. Når du er klar, oppretter du en PR til hovedgrenen. Gjennomgangs- og sammenslåingsprosessene gjøres gjennom en relevant Git-leverandør basert på konfigurasjonen teamet ditt definerte for det repoet.

Når gjennomgangen og flettingen er fullført, opprettes en ny utføring til hovedgrenen. Denne utføringen ber brukeren om å oppdatere innholdet i Utvikling-teamets arbeidsområde med de flettede endringene.

Hvis du vil ha mer informasjon, kan du se forgrening av begrensninger.

Hvordan legge til flere elementer i et arbeidsområde med selektiv forgreining

Når en Fabric-utvikler trenger å legge til elementer som ikke ble valgt under branch-out-operasjonen, beskriver trinnene nedenfor hvordan man legger til flere elementer i arbeidsområdet:

  1. Gå til det nødvendige Fabric-arbeidsområdet, og velg Source control øverst.
  2. Til høyre, velg symbolet med tre prikker .
  3. Bruk nedtrekksmenyen og velg Legg til flere elementer.
  4. Denne handlingen åpner en dialogboks for å velge elementer til arbeidsområdet ditt. Velg elementer-dialogen viser kun elementer fra git-grenen som ikke tidligere var valgt.
  5. Velg de ekstra elementene du vil legge til i arbeidsområdet.
  6. Klikk Legg til. De valgte elementene legges til de ventende oppdateringene i kildekontrollpanelet.
  7. Klikk på Oppdater alle. Denne operasjonen utfører en oppdatering fra git og oppretter elementene i arbeidsområdet.

Bytt grener

Hvis arbeidsområdet er koblet til en Git-gren og du vil bytte til en annen gren, kan du gjøre det raskt fra kildekontrollruten uten å koble fra og koble til på nytt.

Når du bytter grener, blir arbeidsområdet synkronisert med den nye grenen, og alle elementene i arbeidsområdet overstyres. Hvis det finnes forskjellige versjoner av samme element i hver gren, erstattes elementet.

Å utføre switch branch påvirker ikke forholdet (linken) mellom et branch workspace og kildearbeidsområdet. Branch switching er en Git-tilstandsendring. Dermed skaper eller endrer ikke bytte av grener arbeidsområde-relasjoner. Hvis et arbeidsområde allerede har en relasjon, bevares det.

Som standard er bytte av en tilkoblet arbeidsområdes Git-branch (eller å sjekke ut en ny branch) begrenset til workspace-administratorer. En arbeidsområdeadministrator kan imidlertid aktivere innstillingen per arbeidsområde Tillat brukere med minst bidragsyterrolle å endre Git-gren for å tillate grenbytte til medlemmer/bidragsytere. Denne innstillingen er konfigurert per arbeidsområde og krever en aktiv Git-tilkobling. For full tillatelsesmatrise, se Tillatelser.

Notat

Når du bytter grener, slettes elementet hvis arbeidsområdet inneholder et element i den gamle grenen, men ikke den nye. I tillegg, i et arbeidsområde med selektiv forgrening, tilbakestiller en bytteoperasjon gjenstandsvalget, og alle elementer fra den svitsjede grenen synkroniseres til arbeidsområdet.

Følg disse trinnene for å bytte mellom grener:

  1. I kildekontrollpanelet , velg Flere alternativer (...), og velg deretter Switch-gren.

    Skjermbilde av kildekontroll, sjekk ut et nytt grenalternativ.

  2. Angi grenen du vil koble til, eller opprett en ny gren. Denne grenen må inneholde samme katalog som gjeldende gren.

  3. Merk av Jeg forstår at arbeidsområdeelementer kan slettes og ikke kan gjenopprettes. og velg Bytt gren.

    Skjermbilde av å bytte grener.

Du kan ikke bytte grener hvis du har eventuelle uforpliktende endringer i arbeidsområdet. Velg Avbryt for å gå tilbake og utføre endringene før du bytter grener.

Hvis du vil koble gjeldende arbeidsområde til en ny gren mens du beholder den eksisterende arbeidsområdestatusen, velger du Utsjekk ny gren. Mer informasjon om å sjekke ut en ny gren på Løs konflikter i Git.

Utvider deg med en utplasseringsplan

Legg ved en distribusjonsplan når elementer må distribueres i en bestemt rekkefølge, eller når notatbøker, datapipelines eller andre støttede handlinger må kjøres under branch-out. Distribusjonsplanen styrer hvordan Fabric fyller det forgrenede arbeidsområdet; den endrer ikke hvordan Git-grenen eller arbeidsområdet opprettes.

Før du begynner, lagre distribusjonsplanen og commit-en til den nåværende Git-grenen med elementene den refererer til. Kun deployeringsplaner tilgjengelig i Git kan velges under branch-out.

For å utvide med en utplasseringsplan:

  1. Fra fanen Branches i Kildekontrollpanelet , velg Branch out with deployment plan.

    Skjermbilde av Source control-menyen med Branch out med deployeringsplan markert.

  2. Konfigurer den nye grenen og målarbeidsområdet. Velg Neste.

    Skjermbilde av Create-grenen med utplasseringsplan-veiviseren med gren- og arbeidsområdeinnstillinger.

  3. Velg en utplasseringsplan i veiviseren for forgrening. For å bruke standard branch-out-oppførsel, velg Ingen utrullingsplan.

  4. Hvis du valgte Velg elementer individuelt (Forhåndsvisning), velg elementene som skal inkluderes i det forgrenede arbeidsområdet, inkludert elementene som trengs av planens handlinger. Å legge ved planen velger ikke disse elementene for deg.

  5. Velg Opprett gren.

    Skjermbilde av forgreningsveiviseren med en utrullingsplan valgt og arbeidsplass-elementer listet.

Fabric oppretter grenen og arbeidsområdet, og bruker deretter distribusjonsplanen mens det fyller ut målarbeidsområdet. For hvordan de valgte elementene, planforhold, Fabric-linje og handlinger bestemmer utrullingen, se Hvordan en utrullingsplan fungerer.

Å forgrene seg uten distribusjonsplan fungerer som før: Fabric distribuerer de valgte elementene ved hjelp av sin standard avhengighetshåndtering og kjører ikke handlinger før eller etter utrulling.

Begrensninger for forgrening

  • Profilen til grenarbeidsområdet er i Forhåndsvisning.
  • Forgrening krever tillatelser oppført i tillatelsestabellen.
  • Det må være en tilgjengelig kapasitet for denne handlingen.
  • Alle begrensninger for navngivning av arbeidsområder og forgreninger gjelder når du forgrener deg til et nytt arbeidsområde.
  • Bare Git-støttede elementer er tilgjengelige i det nye arbeidsområdet.
  • Listen over relaterte grener viser bare grener og arbeidsområder du har tillatelse til å vise.
  • Git-integrasjon må være aktivert.
  • Når du forgrener deg, opprettes en ny gren, og innstillingene fra den opprinnelige grenen kopieres ikke. Juster eventuelle innstillinger eller definisjoner for å sikre at det nye arbeidsområdet oppfyller organisasjonens retningslinjer.
  • Når en branch workspace kobles fra Git, fjernes også dens relasjon til kildearbeidsområdet.
  • Når man kobler fra et Git-tilkoblet arbeidsområde som har relaterte grenarbeidsområder, fjernes også alle relasjoner mellom grenarbeidsområdene.
  • Når man sletter et arbeidsområde som har relaterte grenarbeidsområder, fjernes alle relasjoner mellom grenarbeidsområdene, og grenarbeidsområdene blir vanlige arbeidsområder.
  • Når du forgrener til et eksisterende arbeidsområde:
    • Målarbeidsområdet må støtte en Git-tilkobling.
    • Brukeren må være administrator for målarbeidsområdet eller Medlem/Bidragsyter på målarbeidsområdet med Tillat brukere med minst Bidragsyter-rolle å endre Git-greninnstillingen aktivert.
    • Målarbeidsområdet må ha kapasitet.
    • Arbeidsområdet kan ikke ha malapper.
    • Målarbeidsområdet kan ikke ha noen relaterte grenarbeidsområder.
    • Når du utvider til et eksisterende arbeidsområde, kan alle gjenstander som ikke er lagret i Git gå tapt. Vi anbefaler at du utføre elementer du vil beholde før du forgrener deg.