View a markdown version of this page

Stellen Sie eine Verbindung zum Quellcode her - AWS Transformieren

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Stellen Sie eine Verbindung zum Quellcode her

Nachher Erstellen Sie einen .NET-Modernisierungsjob, auf der Arbeitsplan Registerkarte, der linke Bereich des AWS Das Transformationsfenster listet die Phasen des Transformationsauftrags auf. Die erste Phase ist Quellcode verbinden. In dieser Phase stellen Sie eine Verbindung zu Ihrem Quellcode her.

Bevor Sie beginnen, stellen Sie sicher, dass Sie über eine AWS Konto mit Berechtigungen zum Erstellen der Quellcodeverbindung. Je nachdem, welche Verbindungsmethode Sie wählen, benötigen Sie auch Zugriff auf AWS CodeConnections, ein persönliches Zugriffstoken (PAT), gespeichert in AWS Secrets Manager oder ein Amazon S3-Bucket im selben AWS Region als Ihr Transformationsjob. Die Erstellung eines Connectors erfordert die Genehmigung durch einen AWS Administrator.

Sie können eine Verbindung zu einem Quellcode-Repository herstellen oder Code in einer ZIP-Datei bereitstellen. Sie haben 4 Möglichkeiten, eine Verbindung zum Quellcode herzustellen:

  • Code-Verbindung: Stellen Sie eine Verbindung zum Quellcode-Repository her mit AWS CodeConnections (GitHub, GitLab, Bitbucket, Azure DevOps).

  • TEIL: Stellen Sie mithilfe eines persönlichen Zugriffstokens, das in gespeichert ist, eine Verbindung zum Quellcode-Repository her AWS Geheimnismanager.

  • S3: Stellen Sie eine Amazon S3-URI für eine Zip-Datei mit einem Codearchiv bereit (z. B. s3://my-bucket/repos.zip).

  • Direkter Upload: Ziehen Sie eine Zip-Datei aus dem Codearchiv per Drag & Drop in das Chat-Fenster.

Wählen Sie eine Code-Verbindungsmethode und der Agent führt Sie durch die Einrichtung.

Stellen Sie eine Verbindung zu einem Repository her mit AWS CodeConnections

Wenn Sie die Option Codeverbindung wählen, wird AWS Der Transform Agent verwendet AWS CodeConnections um Ihre.NET-Codebasis von Azure Repos, Bitbucket herunterzuladen, GitHub, oder GitLab. Transformierter Code wird in einen neuen beschreibbaren Zweig geschrieben. Sie müssen Folgendes einrichten AWS CodeConnections in derselben Region wie Ihre AWS Job transformieren.

Anmerkung

Wenn Sie einen vorhandenen Quellcode-Repository-Connector haben, AWS Transform wird Sie benachrichtigen. Wählen Sie Verwenden Sie den vorhandenen Connector um diesen Connector zu verwenden. Wenn Sie den vorhandenen Connector nicht verwenden möchten, lesen Sie Löschen eines vorhandenen Connectors vor Einen neuen Connector hinzufügen. Sie können nur einen Quell-Repository-Connector pro Job haben.

Einen neuen Connector hinzufügen

Um einen neuen Quellcode-Repository-Connector zu erstellen:

  1. Geben Sie den ein AWS Kontonummer, die Sie für die verwenden möchten AWS CodeConnections Anschluss.

  2. Wenn Sie nicht eingerichtet haben AWS CodeConnections für das Gleiche AWS Konto, einrichten AWS CodeConnections.

  3. Benutze das AWS Konsole für Entwickler-Tools um eine Verbindung zu Ihrem herzustellen Bitbucket, GitHub, GitHub Unternehmensserver, GitLab, oder AzureDevOps Endlager.

  4. Kopieren Sie den Amazon-Ressourcennamen (ARN) der Verbindung, die Sie erstellt haben.

  5. Kehren Sie zurück zu AWS Transformieren Sie den ARN der Verbindung, die Sie erstellt haben, und fügen Sie ihn ein.

  6. Geben Sie einen Namen für den Connector ein.

    Anmerkung

    Geben Sie keine persönlichen Daten als Teil des Connectornamens ein.

  7. Wählen Sie Initiieren Sie die Connector-Erstellung.

  8. AWS Transform stellt die Anforderung, einen Connector zu erstellen für AWS Konto, das Sie eingegeben haben, in derselben Region wie der aktuelle Transformationsauftrag, und informiert Sie, dass eine Genehmigungsanfrage zur Genehmigung durch Ihren AWS Administrator in der AWS Management-Konsole. Wählen Sie Kopieren Sie den Bestätigungslink.

  9. Wenn du der bist AWS Administrator, melden Sie sich bei AWS Konto und gehen Sie zum Bestätigungslink, um die Verbindungsanfrage zu genehmigen. Wenn du nicht der bist AWS Administrator, geben Sie den Bestätigungslink zu Ihrem AWS Administrator.

  10. Nach dem AWS Der Administrator genehmigt die Connector-Anfrage, wählen Sie Connector finalisieren um den Connector-Erstellungsprozess abzuschließen. Wenn Sie einen anderen Connector verwenden möchten, wählen Sie Starten Sie neu, um den Connector-Erstellungsprozess neu zu starten.

Die Registerkarte „Zusammenarbeit“ enthält auch Details zu Ihrem Connector, darunter:

  • Status — Genehmigt oder Genehmigung ausstehend

  • AWS Konto-ID

  • AWS Region

  • Verbindung ARN

Löschen eines vorhandenen Connectors

Anmerkung

Wenn Sie einen vorhandenen Quellcode-Repository-Connector haben, AWS Transform wird Sie benachrichtigen. Wählen Sie entweder Verwenden Sie den vorhandenen Connector oder Löschen Sie und erstellen Sie einen neuen Connector.

Wenn Sie sich dafür entscheiden, ein vorhandenes Quellcode-Repository zu löschen, verbinden Sie sich, AWS Transform warnt Sie, bevor der Connector tatsächlich gelöscht wird.

  1. Sie können einen vorhandenen Connector auf verschiedene Arten löschen:

    1. Wenn AWS Transform fordert Sie dazu auf, können Sie wählen Löschen Sie und erstellen Sie einen neuen Connector.

    2. Sie können auch wählen Neustart in der Eingabeaufforderung, Um diesen Connector zu ändern, müssen Sie ihn neu starten.

  2. AWS Transform warnt Sie, dass durch einen Neustart der Connector gelöscht wird. Um den Connector zu löschen, wählen Sie Starten Sie neu nochmal.

  3. AWS Transform warnt dich erneut davor, dass durch das Löschen des Connectors die Verbindung zu deinem Drittanbieter-Repository wie Bitbucket entfernt wird. GitHub, und GitLab. Ebenfalls, irgendein AWS Transformationsaufträge, die diesen Connector verwenden, schlagen fehl, wenn der Connector gelöscht wird. Um das Löschen zu bestätigen, geben Sie Folgendes ein löschen und wähle Löschen.

  4. Informationen zum Hinzufügen eines neuen Quellcode-Repository-Connectors finden Sie unter Einen neuen Connector hinzufügen.

Stellen Sie mit einem persönlichen Zugriffstoken eine Verbindung zu einem Repository her

Sie können mit einem Personal Access Token (PAT) eine Verbindung zu einem Repository herstellen. Dazu gehen Sie wie folgt vor:

  1. Wenn der Agent nach einer Quellcode-Verbindung fragt, wählen Sie TEIL im Chat-Bereich.

  2. Lesen Sie die angezeigten Anweisungen zum Generieren und Speichern eines PAT in AWS Verwaltung von Geheimnissen.

  3. Generieren Sie eine PAT aus Ihrer Quellcodeverwaltung.

  4. Speichern Sie Ihr PAT in AWS Secrets Manager und notieren Sie den Amazon-Ressourcennamen (ARN). Zum Beispiel ein GitHub Token ist wie folgt formatiert:

    github_pat_XXXXXXXXXXXXXXX
  5. Wählen Sie im Chat das Connector einrichten Link zum Öffnen eines Connector-Formulars.

  6. Geben Sie im Connector-Formular einen Connector-Namen ein, Ihren AWS Konto-ID, die geheime ARN und optional eine KMS-Schlüssel-ARN. Senden Sie dann das Formular ab.

  7. Der Agent stellt einen Genehmigungslink bereit. Kopieren Sie den Link und senden Sie ihn an einen Administrator, um die Verbindung zu genehmigen. Fahren Sie nach der Genehmigung mit dem Agenten fort.

Stellen Sie eine Verbindung zum Quellcode in Amazon S3 her

Sie können eine Verbindung herstellen AWS Transformieren Sie in Amazon S3 in Quellcode als Alternative zu ein Quellcode-Repository verbinden.

S3-Bucket-Organisation

Der ursprüngliche Quellcode und der transformierte Code werden in einem gemeinsamen S3-Bucket gespeichert, der wie unten gezeigt organisiert ist. Sie müssen Ihren S3-Bucket in derselben Region wie Ihr einrichten AWS Job transformieren. Laden Sie Ihren Quellcode als Zip-Datei auf Stammebene in den Bucket hoch. Die Zip-Datei muss für jedes Repository einen Ordner auf oberster Ebene enthalten.

Während der Transformation AWS Transform erstellt einen Transformationsausgabeordner und speichert die Transformationsergebnisse in diesem Ordner. Transformation erstellt eine Zip-Datei mit dem Namen transformed-code.zip enthält den transformierten Code. Dazu gehört ein Bericht mit dem Namen diff.txt für den Bericht über Codeunterschiede, der Dateiänderungen auf Projektebene hervorhebt.

<customer-bucket>/ ├── source-code.zip ├── repo 1 ├── repo 2 ├── ...... ├── repo n └── transform-output/ ├── transformed-code.zip

Einen neuen S3-Connector hinzufügen

So erstellen Sie einen neuen S3-Quellcode-Repository-Connector:

  1. In der AWS Konsole, erstellen Sie einen S3-Bucket.

  2. Laden Sie Ihren Quellcode als Zip-Datei in den S3-Bucket hoch.

  3. In der AWS Web-App transformieren, starten Sie einen .NET-Transformationsjob. In der Verbinde ein Quellcode-Repository Schritt, wählen Verbinden Sie Ihren Quellcode im S3-Bucket und wähle Speichern.

  4. Geben Sie auf der nächsten Seite Ihre S3-Bucket-Details ein und wählen Sie Abschicken.

    1. Name des Konnektors

    2. AWS Konto-ID

    3. S3 Bucket Arn

    4. S3-Bucket-Verschlüsselungsschlüssel (optional)

  5. Genehmigen Sie den Connector:

    1. Kopieren Sie auf der nächsten Seite den Bestätigungslink.

    2. Bitten Sie einen Genehmiger, zu dem Link zu navigieren, um den AWS Anforderungsseite zur Erstellung eines Transform-Connectors.

    3. Wählen Sie, ob Sie eine neue Rolle erstellen oder eine vorhandene Rolle verwenden möchten.

    4. Nachdem Sie die Anfrage überprüft haben, wählen Sie Speichern und Genehmigen um es zu genehmigen.

  6. Geben Sie den Speicherort der S3-Zip-Datei an:

    1. In der AWS Transformieren Sie die Web-App und warten Sie, bis der Status angezeigt wird Genehmigt.

    2. Auf dem Geben Sie den Standort des Objekts an Seite, geben Sie eine S3-URL für die Code-Zip-Datei im Format ein s3://bucket-name/zip-file-name und wähle Senden an AWS Transformieren.

    3. Der Job geht weiter zum Entdeckung Schritt, um die Transformation fortzusetzen.

Löschen eines S3-Connectors

Um einen vorhandenen S3-Connector zu löschen:

  1. In der AWS Wählen Sie die Web-App transformieren Konnektoren verwalten oben rechts.

  2. In der Konnektoren verwalten Fenster, wählen Sie den Connector aus.

  3. Wählen Sie Löschen aus.