Cli-referens för Enterprise Live Migrations (ELM)

Azure DevOps-tjänster

I den här artikeln visas de Azure DevOps CLI-kommandon och parametrar som du använder för att köra Enterprise Live Migrations (ELM), tillsammans med status- och fasvärden som CLI returnerar under en migrering.

Commands

Migreringskommandon

Command Obligatoriska parametrar Valfria parametrar HTTP Description
list --org --project, , --include-all--detect GET Lista migreringar. Som standard returnerar CLI endast den aktiva migreringen för varje lagringsplats. Använd --include-all för att inkludera slutförda, misslyckade och pausade migreringar.
status --org, --repository-id --detect GET Få detaljerad status för en migrering.
create --org, --repository-id, , --target-repository--agent-pool --target-owner-user-id, --service-endpoint-id, --github-token, --validate-only, --cutover-date, --skip-validation, , --enable-boards-github-connection, --enable-auto-discover-pipelines, , --pipeline-service-connection-id--detect POST Skapa en ny migrering. Om du inte skickar kontrollerar --service-endpoint-idELM_GITHUB_TOKEN CLI och kör sedan GitHub enhetsflöde för att autentisera mot målet.
pause --org, --repository-id --detect PUT Pausa en aktiv migrering.
resume --org, --repository-id --validate-only, , --migration--detect PUT Återuppta en stoppad migrering.
cutover set --org, , --repository-id--date --detect PUT Schemalägg ett snabbdatum och tid. Värdet måste vara i framtiden.
cutover cancel --org, --repository-id --detect PUT Avbryt en schemalagd snabb uppdatering. Endast giltigt medan fasen är Synchronization; avvisas när steget avancerar till Cutover. DateTimeOffset.MinValue Skickar sentinel (0001-01-01T00:00:00+00:00) eftersom servern ignorerar null för scheduledCutoverDate.
cutover review --org, --repository-id --detect GET Visa en lista över obearbetade objekt och krav på pipelineverifiering som väntar på godkännande.
cutover approve --org, --repository-id --accept-failures, , --pipelines-verified--detect PUT Godkänn snabbkoppling genom att acceptera obearbetade objekt och/eller verifiera omkopplade pipelines. Ange minst en av --accept-failures eller --pipelines-verified. Oåterkallelig – inget återkallande-API; återställ med abandon + återskapa.
abandon --org, --repository-id --remove-read-only, , --yes--detect DELETE Avbryt en migrering. Migreringsposten rensas inte och pipeline-omkopplingsdata behålls, så en senare migrering kan återanvända den. Uppmanar till bekräftelse om du inte skickar --yes.

Omkopplingskommandon för pipeline (förhandsversion)

Pipeline som omdirigerar ompunkter pipelines som refererar till källan Azure-lagringsplatser lagringsplatsen på den migrerade GitHub lagringsplatsen. Omkoppling är alltid tillgängligt för migrering i något av två lägen:

  • Identifiera automatiskt – skicka --enable-auto-discover-pipelines tillsammans med --pipeline-service-connection-id på create. ELM-synkroniseringsjobbet vägleder källlagringsplatsen och skapar klondefinitioner för varje pipeline som refererar till den.
  • Manuell – registrera specifika pipelines efter create med pipelines submit. Du kan blanda båda lägena och justera registreringen när som helst med pipelines update.
Command Obligatoriska parametrar Valfria parametrar HTTP Description
pipelines list --org, --repository-id --detect GET Visa en lista över konfigurationer för pipelinerewiring och status per pipeline.
pipelines submit --org, , --repository-id--pipeline-ids --service-connection-id, , --repository-mapping--detect POST Registrera specifika pipelines för omkoppling.
pipelines update --org, --repository-id --add-ids, --remove-ids, --retry-ids, --service-connection-id, , , --repository-mapping--detect PUT Masstillägg, ta bort, försök igen eller ändra tjänstanslutningen för registrerade pipelines. Minst en uppdateringsflagga krävs.
pipelines retry --org, , --repository-id--pipeline-ids --detect PUT Försök att göra om misslyckade pipeline-omkopplingsförsök.
pipelines delete --org, , --repository-id--migration-id --yes, --detect DELETE Ta bort pipelinerewiringsdata (konfigurations- och klonade definitioner) för en migrering. Använd detta för att rensa omkopplingsdata för en misslyckad migrering. abandon ensam tar inte bort den.

Parameterinformation

Parameter Type Används av Description
--org URL All Azure DevOps organisations-URL, till exempel https://dev.azure.com/<org>. Ange det här värdet som standard.
--repository-id GUID Alla utom list Azure-lagringsplatser lagringsplats-GUID. Hämta värdet från az repos show --query id. Migreringar identifieras endast av repositoryId – API-svaret har inget separat migrerings-ID-fält och det kan finnas högst en aktiv migrering per lagringsplats.
--target-repository URL create Mållagringsplatsens URL, till exempel https://<enterprise>.ghe.com/<org>/<repo>. Måste börja med http:// eller https://. Servern validerar det här värdet.
--target-owner-user-id string create GitHub användar-ID (handtag) för mållagringsplatsens ägare. Inaktuell och ignorerad när tokenbaserad ägarmatchning på serversidan är aktiverad.
--service-endpoint-id GUID create Optional. Azure DevOps tjänstanslutnings-ID för den GitHub Enterprise Server-anslutning som används för att synkronisera incheckningar till målet. När det är inställt hoppas GitHub enhetsflödet över. Oberoende av verifiering av användaridentitet – du kan fortfarande ange --github-token eller ELM_GITHUB_TOKEN vid sidan av den.
--github-token string create Valfritt GitHub användartoken (eller PAT) för verifiering av användaridentitet på målvärden. Om det utelämnas och --service-endpoint-id inte tillhandahålls kontrollerar ELM_GITHUB_TOKEN CLI och kör sedan GitHub enhetsflöde.
--agent-pool string create Agentpoolens namn för migreringsarbete.
--validate-only flagga create, resume På create: kör endast kontroller före migreringen. På resume: växla till valideringsläge. Valideringsresultat upphör att gälla 24 timmar efter att körningen har slutförts. starta (eller flytta upp till) den fullständiga migreringen i det fönstret.
--migration flagga resume Höj upp en lyckad valideringskörning till en fullständig migrering (uppsättningar validateOnly=false och statusRequested=active). Endast giltig när den tidigare valideringskörningen slutfördes med status: Succeeded. Ömsesidigt uteslutande med --validate-only.
--cutover-date ISO 8601 create Förschemalägg snabbinläsning vid skapandetillfället, till exempel 2030-12-31T11:59:00Z.
--date ISO 8601 cutover set Schemalägg snabb datum och tid, till exempel 2030-12-31T11:59:00Z. Måste vara i framtiden.
--skip-validation string create Kommaavgränsad lista över valideringsprincipnamn eller en icke-negativ heltalsbitmask. Principnamn (skiftlägesokänsliga): , , , , AgentPoolExists, MaxFileSize, MaxPullRequestSize, MaxPushPackSize, MaxReferenceNameLength, TargetRepositoryDoesNotExist, , SourceRepositoryContainsLfsObjects, SourceRepositoryNotReadOnly, , BoardsGitHubConnectionProvisioning, All. PullRequestDeltaSizeActivePullRequestCountNone
--enable-boards-github-connection (--enable-boards-gh) flagga create Välj att etablera Azure-tavlor GitHub anslutning vid snabbkoppling. Inaktiverad som standard. Kräver att Azure-tavlor GitHub-appen installeras på målorganisationen GitHub innan migreringen körs.
--enable-auto-discover-pipelines (--auto-discover) flagga create Anmäl dig till automatisk pipelineidentifiering vid snabb användning. Inaktiverad som standard. Kräver --pipeline-service-connection-id; CLI avvisar kommandot om du skickar den här flaggan utan en tjänstanslutning.
--pipeline-service-connection-id (--pipeline-sc-id) GUID create Project omfångsbegränsat GitHub tjänstanslutnings-ID som är kopplat vid tidpunkten för att skapa en pipelineomkoppling. Krävs för automatisk identifiering; valfritt i manuellt läge, där den föransluter anslutningen så att senare pipelines submit anrop bara behöver --pipeline-ids.
--accept-failures integer cutover approve Antal obearbetade migreringsresurser som ska accepteras innan du fortsätter med snabb användning. Ange detta och/eller --pipelines-verified.
--pipelines-verified flagga cutover approve Bekräfta att alla omkopplade pipelines har verifierats. Krävs när cutover review returnerar requiresPipelineVerificationAcknowledgment: true. Kan kombineras med --accept-failures i ett samtal.
--pipeline-ids int-lista pipelines submit, pipelines retry Definitions-ID för pipeline. Accepterar blankstegsavgränsade (42 43 44) eller kommaavgränsade (42,43,44) värden.
--service-connection-id GUID pipelines submit, pipelines update Project GitHub tjänstanslutnings-ID. Valfritt om submit en anslutning redan var ansluten vid skapandetillfället eller via pipelines update.
--add-ids / --remove-ids / --retry-ids int-lista pipelines update Pipeline-ID:t som ska läggas till, ta bort från eller försöka igen i omkopplingsuppsättningen.
--repository-mapping string pipelines submit, pipelines update Lagringsplatsmappning i formuläret <sourceRepoId>=<targetOwner>/<targetRepo>. Målet måste vara i owner/repo form, inte en URL. Kan tillhandahållas flera gånger.
--migration-id integer pipelines delete Migrerings-ID som används för rensning av pipelinerewiring. Läs det från prefixet Migration NN: i texten migrations statusi validationIssues .
--remove-read-only flagga abandon Efter cutover är källlagringsplatsen Azure DevOps inställd på skrivskyddad. Lägg till den här flaggan för att återställa skrivåtkomsten. Gäller endast efter cutover.
--yes (-y) flagga abandon, pipelines delete Hoppa över den interaktiva bekräftelseprompten. Användbart för skriptrensning.
--include-all flagga list Returnera den fullständiga migreringshistoriken per lagringsplats, inklusive slutförda, misslyckade och pausade migreringar. (--include-inactive är ett inaktuellt alias.)
--detect flagga All Identifiera organisationen automatiskt från git-fjärren (standard: true). Använd --detect false för att inaktivera.

Migreringssteg

Stadium Description
Köad Migrering accepterad; arbetet har inte startat ännu.
Validation Kör kontroller före migreringen.
Synchronization Kopiera och synkronisera lagringsplatsens innehåll.
Driftsättning Kör den slutliga synkroniseringen och övergången till GitHub.
ReviewForCutover Cutover nådde den schemalagda tiden med olösta fel och väntar cutover approve på (eller omplanerar).
ReadyForCutover Godkänd och väntar på att nästa ELM-jobb ska utföra den sista cutovern.
Migrerad Migreringen har slutförts. GitHub är det primära systemet.

Migreringsstatus

Status Meaning
Active Migreringen pågår.
lyckades Den aktuella fasen har slutförts framgångsrikt.
Har slutförts Migreringen nådde terminalsteget Migrated .
Misslyckades Det uppstod ett fel. Du kan återuppta migreringen efter att du har åtgärdat problemet.
Avstängd Pausades manuellt. Du kan återuppta migreringen.

Relaterat innehåll

  • Last updated on