Naslaginformatie over ENTERPRISE Live Migrations (ELM) CLI

Azure DevOps Services

Dit artikel bevat de Azure DevOps CLI-opdrachten en -parameters die u gebruikt om ELM (Enterprise Live Migrations) uit te voeren, samen met de status- en fasewaarden die de CLI tijdens een migratie retourneert.

Commands

Migratieopdrachten

Opdracht Benodigde parameters Optionele parameters HTTP Description
list --org --project, , --include-all--detect GET Migraties vermelden. Standaard retourneert de CLI alleen de actieve migratie voor elke opslagplaats. Gebruik --include-all dit om voltooide, mislukte en onderbroken migraties op te nemen.
status --org, --repository-id --detect GET Gedetailleerde status voor één migratie ophalen.
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 Maak een nieuwe migratie. Als u niet doorgeeft--service-endpoint-id, controleert ELM_GITHUB_TOKEN de CLI GitHub apparaatstroom om te verifiëren bij het doel.
pause --org, --repository-id --detect PUT Een actieve migratie onderbreken.
resume --org, --repository-id --validate-only, , --migration--detect PUT Een gestopte migratie hervatten.
cutover set --org, , --repository-id--date --detect PUT Een cutover-datum en -tijd plannen. De waarde moet in de toekomst zijn.
cutover cancel --org, --repository-id --detect PUT Een geplande cutover annuleren. Alleen geldig terwijl fase is Synchronization; geweigerd zodra de fase naar .Cutover Hiermee wordt de DateTimeOffset.MinValue sentinel (0001-01-01T00:00:00+00:00) verzonden omdat de server wordt null genegeerd voor scheduledCutoverDate.
cutover review --org, --repository-id --detect GET Lijst met niet-verwerkte items en vereisten voor pijplijnverificatie die wachten op goedkeuring.
cutover approve --org, --repository-id --accept-failures, , --pipelines-verified--detect PUT Keur cutover goed door niet-verwerkte items te accepteren en/of opnieuw ingerichte pijplijnen te verifiëren. Geef ten minste één van --accept-failures of --pipelines-verified. Onherstelbaar — geen ingetrokken API; herstellen met abandon + opnieuw maken.
abandon --org, --repository-id --remove-read-only, , --yes--detect Verwijderen Een migratie afbreken. De migratierecord wordt niet opgeschoond en gegevens voor het opnieuw draaien van pijplijnen blijven behouden, zodat deze later opnieuw kan worden gemigreerd. Wordt om bevestiging gevraagd, tenzij u doorgeeft --yes.

Opdrachten voor opnieuw draaien van pijplijnen (preview)

Pijplijn herwiring van pijplijnen die verwijzen naar de bron-Azure-opslagplaatsen opslagplaats in de gemigreerde GitHub opslagplaats. Herwiring is altijd beschikbaar voor een migratie, in een van de twee modi:

  • Automatisch detecteren - samen met --enable-auto-discover-pipelines aan --pipeline-service-connection-iddoorgevencreate. De ELM-synchronisatietaak begeleidt de bronopslagplaats en maakt kloondefinities voor elke pijplijn die ernaar verwijst.
  • Handmatig : schrijf specifieke pijplijnen in nacreate.pipelines submit U kunt beide modi combineren en inschrijving op elk gewenst moment aanpassen met pipelines update.
Opdracht Benodigde parameters Optionele parameters HTTP Description
pipelines list --org, --repository-id --detect GET Maak een lijst met opnieuw draaiende configuratie van pijplijnen en status per pijplijn.
pipelines submit --org, , --repository-id--pipeline-ids --service-connection-id, , --repository-mapping--detect POST Schrijf specifieke pijplijnen in voor het opnieuw draaien.
pipelines update --org, --repository-id --add-ids, , --remove-ids--retry-ids, --service-connection-id, , , --repository-mapping--detect PUT Bulksgewijs toevoegen, verwijderen, opnieuw proberen of wijzigen van de serviceverbinding voor ingeschreven pijplijnen. Er is ten minste één updatevlag vereist.
pipelines retry --org, , --repository-id--pipeline-ids --detect PUT Opnieuw proberen mislukte pijplijn opnieuw te draaien vermeldingen.
pipelines delete --org, , --repository-id--migration-id --yes, --detect Verwijderen Verwijder pijplijngegevens (configuratie- en gekloonde definities) voor een migratie. Gebruik deze optie om het opnieuw draaien van gegevens op te schonen voor een mislukte migratie; abandon alleen verwijdert het niet.

Parametergegevens

Parameter Type Wordt gebruikt door Description
--org URL All Azure DevOps organisatie-URL, bijvoorbeeld https://dev.azure.com/<org>. Stel deze waarde in als een standaardwaarde.
--repository-id GUID Alles behalve list Azure-opslagplaatsen opslagplaats-GUID. Haal de waarde op uit az repos show --query id. Migraties worden alleen geïdentificeerd door repositoryId : het API-antwoord heeft geen afzonderlijk migratie-id-veld en er kan maximaal één actieve migratie per opslagplaats zijn.
--target-repository URL create URL van doelopslagplaats, bijvoorbeeld https://<enterprise>.ghe.com/<org>/<repo>. Moet beginnen met http:// of https://. De server valideert deze waarde.
--target-owner-user-id string create GitHub gebruikers-id (handle) van de eigenaar van de doelopslagplaats. Afgeschaft en genegeerd wanneer de oplossing van tokens op basis van tokens is ingeschakeld.
--service-endpoint-id GUID create Optional. Azure DevOps serviceverbindings-id voor de GitHub Enterprise Server-verbinding die wordt gebruikt voor het synchroniseren van doorvoeringen naar het doel. Wanneer dit is ingesteld, wordt GitHub apparaatstroom overgeslagen. Onafhankelijk van verificatie van gebruikersidentiteiten, kunt u deze nog steeds leveren --github-token of ELM_GITHUB_TOKEN ernaast.
--github-token string create Optioneel GitHub gebruikerstoken (of PAT) voor verificatie van gebruikersidentiteiten op de doelhost. Als u dit weglaat en --service-endpoint-id niet wordt opgegeven, controleert ELM_GITHUB_TOKEN de CLI GitHub apparaatstroom.
--agent-pool string create Naam van agentgroep voor migratiewerk.
--validate-only flag create, resume Op create: voer controles vóór de migratie alleen uit. Aan resume: schakel over naar de modus Alleen-valideren. Alleen-valideren resultaten verlopen 24 uur nadat de uitvoering is geslaagd; start (of promovatie naar) de volledige migratie in dat venster.
--migration flag resume Niveau verhogen van een geslaagde alleen-valideren-uitvoering naar een volledige migratie (sets validateOnly=false en statusRequested=active). Alleen geldig wanneer de vorige alleen-valideren-uitvoering is voltooid met status: Succeeded. Wederzijds uitsluiten met --validate-only.
--cutover-date ISO 8601 create Cutover vooraf plannen tijdens het maken, bijvoorbeeld 2030-12-31T11:59:00Z.
--date ISO 8601 cutover set Een cutover-datum en -tijd plannen, bijvoorbeeld 2030-12-31T11:59:00Z. Moet in de toekomst zijn.
--skip-validation string create We raden u ten zeerste aan deze parameter te vermijden, omdat dit het risico op migratiefouten aanzienlijk verhoogt, zoals wordt uitgelegd in Introduction to Enterprise Live Migrations (ELM). Door komma's gescheiden lijst met validatiebeleidsnamen of een niet-negatief geheel getal bitmasker. Beleidsnamen (hoofdlettergevoelig): None, ActivePullRequestCount, PullRequestDeltaSize, , AgentPoolExists, , MaxFileSize, MaxPullRequestSizeMaxPushPackSizeMaxReferenceNameLengthTargetRepositoryDoesNotExist, SourceRepositoryContainsLfsObjects, SourceRepositoryNotReadOnly, . BoardsGitHubConnectionProvisioningAll
--enable-boards-github-connection (--enable-boards-gh) flag create Meld u aan voor het inrichten van de Azure Boards GitHub-verbinding bij cutover. Standaard uitgeschakeld. Vereist dat de Azure Boards GitHub-app is geïnstalleerd op de doel-GitHub organisatie voordat de migratie wordt uitgevoerd.
--enable-auto-discover-pipelines (--auto-discover) flag create Meld u aan voor automatische pijplijndetectie bij cutover. Standaard uitgeschakeld. Vereist --pipeline-service-connection-id; de CLI weigert de opdracht als u deze vlag zonder serviceverbinding doorgeeft.
--pipeline-service-connection-id (--pipeline-sc-id) GUID create Project-scoped GitHub serviceverbindings-id gekoppeld tijdens het maken van pijplijnen. Vereist voor automatische detectie; optioneel in de handmatige modus, waarbij de verbinding vooraf wordt gekoppeld, zodat latere pipelines submit aanroepen alleen nodig zijn --pipeline-ids.
--accept-failures geheel getal cutover approve Het aantal niet-verwerkte migratiebronnen dat moet worden geaccepteerd voordat u doorgaat met cutover. Geef dit en/of --pipelines-verified.
--pipelines-verified flag cutover approve Bevestig dat alle gerewired pijplijnen zijn geverifieerd. Vereist wanneer cutover review retourneert requiresPipelineVerificationAcknowledgment: true. Kan in één gesprek worden gecombineerd --accept-failures .
--pipeline-ids lijst met int pipelines submit, pipelines retry Id's voor pijplijndefinities. Accepteert door spaties gescheiden (42 43 44) of door komma's gescheiden (42,43,44) waarden.
--service-connection-id GUID pipelines submit, pipelines update Project-scoped GitHub serviceverbindings-id. Optioneel als submit er al een verbinding is gekoppeld tijdens het maken of via pipelines update.
--add-ids / --remove-ids / --retry-ids lijst met int pipelines update Pijplijn-id's om toe te voegen aan, te verwijderen uit of opnieuw te proberen binnen de set voor opnieuw draaien.
--repository-mapping string pipelines submit, pipelines update Opslagplaatstoewijzing in het formulier <sourceRepoId>=<targetOwner>/<targetRepo>. Het doel moet in owner/repo vorm zijn, geen URL. Kan meerdere keren worden opgegeven.
--migration-id geheel getal pipelines delete Migratie-id die wordt gebruikt voor het opschonen van pijplijnen. Lees het uit het Migration NN: voorvoegsel in de validationIssues tekst van migrations status.
--remove-read-only flag abandon Na cutover is de bron-Azure DevOps opslagplaats ingesteld op alleen-lezen. Voeg deze vlag toe om schrijftoegang te herstellen. Alleen van toepassing na cutover.
--yes (-y) flag abandon, pipelines delete Sla de interactieve bevestigingsprompt over. Handig voor het opschonen van scripts.
--include-all flag list Retourneert de volledige migratiegeschiedenis per opslagplaats, inclusief voltooide, mislukte en onderbroken migraties. (--include-inactive is een afgeschafte alias.)
--detect flag All Organisatie automatisch detecteren vanuit de externe Git-instantie (standaard: true). Gebruik --detect false om uit te schakelen.

Migratiefasen

Stage Description
In wachtrij geplaatst Migratie geaccepteerd; het werk is nog niet gestart.
Validation Controles vóór de migratie uitvoeren.
Synchronization Inhoud van opslagplaats kopiëren en synchroniseren.
Omschakeling De laatste synchronisatie en overgang naar GitHub uitvoeren.
ReviewForCutover Cutover heeft de geplande tijd bereikt met niet-opgeloste fouten en wacht op cutover approve (of opnieuw plannen).
ReadyForCutover Goedgekeurd en wachtend op de volgende ELM-taak om de uiteindelijke cutover uit te voeren.
Gemigreerd De migratie is voltooid. GitHub is het recordsysteem.

Migratiestatussen

Status Meaning
Active Migratie wordt uitgevoerd.
Succeeded De huidige fase is voltooid.
Volbracht De migratie heeft de terminalfase Migrated bereikt.
Mislukt Er is een fout opgetreden. U kunt de migratie hervatten nadat het probleem is opgelost.
Opgeschort Handmatig gepauzeerd. U kunt de migratie hervatten.

Verwante inhoud

  • Laatst bijgewerkt om