View a markdown version of this page

Connect zum Quellcode herstellen - AWS Transformieren
Stellen Sie eine Connect zu einem Repository her mit AWS CodeConnectionsStellen Sie mit einem Personal Access Token eine Connect zu einem Repository herConnect zum Quellcode in Amazon S3 her

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.

Connect zum Quellcode herstellen

Erstellen Sie einen .NET-ModernisierungsjobDanach werden auf der Registerkarte Jobplan im linken Bereich des AWS Transformationsfensters die Phasen des Transformationsjobs aufgeführt. Die erste Phase ist der Connect-Quellcode. In dieser Phase stellen Sie eine Verbindung zu Ihrem Quellcode her.

Bevor Sie beginnen, stellen Sie sicher, dass Sie über ein AWS Konto mit Berechtigungen zum Herstellen der Quellcodeverbindung verfügen. Je nach der von Ihnen gewählten Verbindungsmethode benötigen Sie außerdem Zugriff AWS CodeConnections auf ein in AWS Secrets Manager gespeichertes Personal Access Token (PAT) oder auf einen Amazon S3 S3-Bucket in derselben AWS Region wie Ihr Transformationsjob. Das Erstellen 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:

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

  • PAT: Stellen Sie mithilfe eines in AWS Secrets Manager gespeicherten Personal Access Tokens eine Verbindung zum Quellcode-Repository her.

  • S3: Geben Sie eine Amazon S3 S3-URI für eine Code-Archiv-ZIP-Datei an (z. B.s3://my-bucket/repos.zip).

  • Direkter Upload: Ziehen Sie eine Code-Archiv-ZIP-Datei per Drag & Drop in den Chat-Bereich.

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

Stellen Sie eine Connect zu einem Repository her mit AWS CodeConnections

Wenn Sie die Option Code Connection wählen, verwendet der AWS Transform-Agent, AWS CodeConnectionsum Ihre .NET-Codebasis von Azure Repos, Bitbucket, GitHub oder herunterzuladen. GitLab Transformierter Code wird in einen neuen beschreibbaren Branch geschrieben. Sie müssen sich AWS CodeConnections in derselben Region wie Ihr AWS Transform-Job einrichten.

Anmerkung

Wenn Sie bereits über einen Quellcode-Repository-Connector verfügen, werden Sie von AWS Transform benachrichtigt. Wählen Sie Bestehenden Konnektor verwenden aus, um diesen Konnektor zu verwenden. Wenn Sie den vorhandenen Konnektor nicht verwenden möchten, lesen Sie weiter Löschen eines vorhandenen Connectors obenEinen 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 die AWS Kontonummer ein, die Sie für den AWS CodeConnections Connector verwenden möchten.

  2. Wenn Sie nicht AWS CodeConnections für dasselbe AWS Konto eingerichtet haben, klicken Sie auf Einrichten AWS CodeConnections.

  3. Verwende die AWS Developer Tools Console, um eine Verbindung zu deinem Bitbucket GitHub, GitHub Enterprise Server oder AzureDevOpsRepository herzustellen. GitLab

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

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

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

    Anmerkung

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

  7. Wählen Sie Konnektorerstellung initiieren aus.

  8. AWS Transform stellt die Anforderung zur Erstellung eines Connectors für das von Ihnen eingegebene AWS Konto in derselben Region wie der aktuelle Transformationsjob und benachrichtigt Sie, dass eine Genehmigungsanfrage bereit ist, von Ihrem AWS Administrator in der AWS Management Console genehmigt zu werden. Wählen Sie Bestätigungslink kopieren aus.

  9. Wenn Sie der AWS Administrator sind, melden Sie sich AWS bei dem Konto an und klicken Sie auf den Bestätigungslink, um die Verbindungsanfrage zu genehmigen. Wenn Sie nicht der AWS Administrator sind, geben Sie den Bestätigungslink an Ihren AWS Administrator weiter.

  10. Nachdem der AWS Administrator die Connector-Anfrage genehmigt hat, wählen Sie Connector finalisieren aus, um den Connector-Erstellungsprozess abzuschließen. Wenn Sie einen anderen Connector verwenden möchten, wählen Sie Restart aus, um den Connector-Erstellungsprozess neu zu starten.

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

  • Status — Genehmigt oder Genehmigung steht noch aus

  • AWS Konto-ID

  • AWS Region

  • Verbindung ARN

Löschen eines vorhandenen Connectors

Anmerkung

Wenn Sie über einen vorhandenen Quellcode-Repository-Connector verfügen, werden Sie von AWS Transform benachrichtigt. Wählen Sie entweder Bestehenden Connector verwenden oder Löschen und erstellen Sie einen neuen Connector.

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

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

    1. Wenn Sie von AWS Transform dazu aufgefordert werden, können Sie Löschen auswählen und einen neuen Connector erstellen.

    2. Sie können in der Aufforderung auch „Neu starten“ auswählen. Um diesen Konnektor zu ändern, müssen Sie neu starten.

  2. AWS Transform warnt Sie davor, dass der Connector durch einen Neustart gelöscht wird. Um den Connector zu löschen, wählen Sie erneut Neu starten.

  3. AWS Transform warnt dich erneut, dass durch das Löschen des Connectors die Verbindung zu deinem Drittanbieter-Repository wie Bitbucket, GitHub, und GitLab entfernt wird. Außerdem schlagen alle AWS Transform-Jobs fehl, die diesen Connector verwenden, wenn der Connector gelöscht wird. Um den Löschvorgang zu bestätigen, geben Sie delete ein und wählen Sie Löschen aus.

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

Stellen Sie mit einem Personal Access Token eine Connect 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 im Chat-Bereich PAT aus.

  2. Lesen Sie die angezeigten Anweisungen zum Generieren und Speichern einer PAT in AWS Secrets Manager.

  3. Generieren Sie eine PAT aus Ihrer Quellcodeverwaltung.

  4. Speichern Sie Ihre PAT in AWS Secrets Manager und notieren Sie sich den Amazon-Ressourcennamen (ARN). Ein GitHub Token ist beispielsweise wie folgt formatiert:

    github_pat_XXXXXXXXXXXXXXX

  5. Wählen Sie im Chat den Link Connector einrichten, um ein Connector-Formular zu öffnen.

  6. Geben Sie im Connector-Formular einen Connectornamen, Ihre AWS Konto-ID, den geheimen ARN und optional einen KMS-Schlüssel-ARN ein. 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.

Connect zum Quellcode in Amazon S3 her

Als Alternative zur Verbindung mit einem Quellcode-Repository können Sie AWS Transform mit dem Quellcode in Amazon S3 verbinden.

Organisation des S3-Buckets

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 Ihren AWS Transform-Job einrichten. Laden Sie Ihren Quellcode als Zip-Datei auf Root-Ebene in den Bucket hoch. Die ZIP-Datei muss für jedes Repository einen Ordner der obersten Ebene enthalten.

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


<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. Erstellen Sie in der AWS Konsole einen S3-Bucket.

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

  3. Starten Sie in der AWS Transform-Web-App einen .NET-Transformationsjob. Wählen Connect im Schritt Ein Quellcode-Repository Connect die Option Ihren Quellcode im S3-Bucket verbinden und wählen Sie Speichern aus.

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

    1. Name des Connectors

    2. AWS Konto-ID

    3. S3 Bucket Arn

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

  5. Genehmigen Sie den Konnektor:

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

    2. Lassen Sie einen Genehmiger den Link aufrufen, um zur Seite mit der Anfrage zur Erstellung des AWS Transform-Connectors zu gelangen.

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

    4. Nachdem Sie die Anfrage geprüft haben, wählen Sie Speichern und genehmigen, um sie zu genehmigen.

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

    1. Warten Sie in der AWS Transform-Web-App, bis der Status Genehmigt angezeigt wird.

    2. Geben Sie auf der Seite „Asset-Speicherort angeben“ eine S3-URL für die Code-Zip-Datei im Format ein s3://bucket-name/zip-file-name und wählen Sie „Zur AWS Transformation senden“.

    3. Der Job wird mit dem Discovery-Schritt fortgeführt, um die Transformation fortzusetzen.

Löschen eines S3-Connectors

Um einen vorhandenen S3-Connector zu löschen:

  1. Wählen Sie in der AWS Transform-Web-App oben rechts die Option Konnektoren verwalten aus.

  2. Wählen Sie im Fenster „Konnektoren verwalten“ den Konnektor aus.

  3. Wählen Sie Löschen aus.