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.

Erste Schritte

In diesem Abschnitt wird beschrieben, wie Sie AWS Transform benutzerdefiniert einrichten und Ihre erste Transformation ausführen.

Voraussetzungen

Stellen Sie vor der Installation von AWS Transform custom sicher, dass Sie über Folgendes verfügen:

Unterstützte Plattformen

AWS Transform custom unterstützt die folgenden Betriebssysteme:

Erforderliche Software

Netzwerkanforderungen

Eine Internetverbindung mit Zugriff auf die folgenden Endpunkte ist erforderlich:

Wenn Sie in einer Umgebung mit eingeschränktem Internet arbeiten, aktualisieren Sie die Firewallregeln, um diese URLs zuzulassen.

Installieren von AWS CLI transformieren

Die empfohlene Installationsmethode ist die Verwendung des Installationsskripts. Wählen Sie die Registerkarte für Ihr Betriebssystem.

Um die AWS Transform CLI zu installieren

Konfigurieren der Authentifizierung

AWS Transform Custom erfordert AWS Anmeldeinformationen, um sich beim Dienst zu authentifizieren. Konfigurieren Sie die Authentifizierung mit einer der folgenden Methoden.

Umgebungsvariablen

Legen Sie die folgenden Umgebungsvariablen fest.

Linux and macOS

export AWS_ACCESS_KEY_ID=your_access_key
export AWS_SECRET_ACCESS_KEY=your_secret_key
export AWS_SESSION_TOKEN=your_session_token

Windows (PowerShell)

$env:AWS_ACCESS_KEY_ID="your_access_key"
$env:AWS_SECRET_ACCESS_KEY="your_secret_key"
$env:AWS_SESSION_TOKEN="your_session_token"

Sie können ein Profil auch mithilfe der AWS_PROFILE Umgebungsvariablen angeben.

Linux and macOS

export AWS_PROFILE=your_profile_name

Windows (PowerShell)

$env:AWS_PROFILE="your_profile_name"

AWS Datei mit Anmeldeinformationen

Konfigurieren Sie die AWS Anmeldeinformationen in der Datei mit den Anmeldeinformationen, die Sie ~/.aws/credentials unter Linux und macOS oder %USERPROFILE%\.aws\credentials unter Windows finden:

[default]
aws_access_key_id = your_access_key
aws_secret_access_key = your_secret_key

IAM-Berechtigungen

Ihre AWS Anmeldeinformationen müssen berechtigt sein, den benutzerdefinierten AWS Transform-Dienst aufzurufen. Wir empfehlen, die AWSTransformCustomFullAccess AWS verwaltete Richtlinie an Ihren IAM-Benutzer oder Ihre IAM-Rolle anzuhängen. Diese Richtlinie bietet vollen Zugriff auf AWS Transform custom, einschließlich der Berechtigung, die serviceverknüpfte Rolle zu erstellen, die für die Übertragung von CloudWatch Metriken an Ihr Konto erforderlich ist.

Für eine detailliertere Steuerung bietet AWS Transform Custom auch die folgenden AWS verwalteten Richtlinien:

Weitere Informationen zu diesen Richtlinien finden Sie unter AWS Verwaltete Richtlinien für AWS Transform. Informationen zu benutzerdefinierten IAM-Richtlinien mit Berechtigungen auf Ressourcenebene finden Sie im AWS Transform Custom IAM Service Authorization Reference Guide.

Konfigurieren AWS Region

AWS Transform custom ist in bestimmten AWS Regionen verfügbar und erkennt Ihre Regionskonfiguration automatisch anhand der AWS Standard-CLI-Priorität.

Unterstützte Regionen

AWS Transform custom ist in den folgenden AWS Regionen verfügbar:

Wie wird die Region bestimmt

Die CLI überprüft diese Quellen in der Reihenfolge ihrer Priorität, um zu ermitteln, welche Region verwendet werden soll:

Deine Region einstellen

Wählen Sie eine dieser Methoden, um Ihre Region zu konfigurieren:

Option 1: Umgebungsvariable (für den temporären Gebrauch empfohlen):

Linux and macOS

export AWS_REGION=<your-region>

Windows (PowerShell)

$env:AWS_REGION="<your-region>"

Option 2: AWS CLI-Konfiguration (empfohlen für die permanente Einrichtung):

aws configure set region <your-region>

Option 3: Profile-specific Konfiguration:

Linux and macOS

aws configure set region <your-region> --profile your_profile_name
export AWS_PROFILE=your_profile_name

Windows (PowerShell)

aws configure set region <your-region> --profile your_profile_name
$env:AWS_PROFILE="your_profile_name"

Option 4: Direkte Dateibearbeitung:

Bearbeiten Sie die AWS Konfigurationsdatei direkt (~/.aws/configunter Linux und macOS oder %USERPROFILE%\.aws\config unter Windows):

[default]
region = <your-region>

[profile your_profile_name]
region = <your-region>

Überprüfen Sie Ihre Regionskonfiguration

Um zu überprüfen, welche Region AWS Transform Custom verwenden wird:

Überprüfen Sie die aktuelle Regionseinstellung:

aws configure get region

Überprüfen Sie die Umgebungsvariablen:

Linux and macOS

echo "AWS_REGION: $AWS_REGION"
echo "AWS_DEFAULT_REGION: $AWS_DEFAULT_REGION"
echo "AWS_PROFILE: $AWS_PROFILE"

Windows (PowerShell)

echo "AWS_REGION: $env:AWS_REGION"
echo "AWS_DEFAULT_REGION: $env:AWS_DEFAULT_REGION"
echo "AWS_PROFILE: $env:AWS_PROFILE"

Sehen Sie sich die detaillierte Regionsauflösung in den Debug-Protokollen an:

Linux and macOS

tail -f ~/.aws/atx/logs/debug.log

Windows (PowerShell)

Get-Content "$env:USERPROFILE\.aws\atx\logs\debug.log" -Wait -Tail 10

Beispiel für eine Protokollausgabe, die die Quelle der Region zeigt:

2026-01-07 22:34:28 [DEBUG]: Initializing FrontendServiceClient with config:
{
  "endpoint": "https://transform-custom.us-east-1.api.aws",
  "region": "us-east-1",
  "regionSource": "AWS_REGION"
}

Das regionSource Feld zeigt, woher die Region abgeleitet wurde (z. B. „aws-config (profile: default)“, „AWS_REGION“, „default“).

Führen Sie Ihre erste Transformation durch

Der schnellste Weg, um loszulegen, ist die Verwendung einer AWS verwalteten Transformation. AWS-verwaltete Transformationen sind vorgefertigte, AWS geprüfte Transformationen, die ohne jegliche Einrichtung sofort einsatzbereit sind.

So führen Sie eine verwaltete Transformation interaktiv aus: AWS

atx

Bitten Sie dann den Agenten, eine Transformation auszuführen:

Execute the AWS/java-aws-sdk-v1-to-v2 transformation on the codebase at ./my-java-project

Um eine Transformation nicht interaktiv auszuführen:

atx custom def exec -n AWS/java-aws-sdk-v1-to-v2 -p ./my-java-project -c "mvn clean install" -x -t

Detaillierte Informationen zu Ausführungsmodi, Konfigurationsoptionen und Befehlsflags finden Sie unter. Referenz zum Befehl

Transformationsergebnisse verstehen

Wenn eine Transformation abgeschlossen ist, liefert AWS Transform custom einen Bericht, in dem die Ergebnisse beschrieben werden. Wenn die Transformation nicht validiert wurde (z. B. erfolgreicher Build für eine Java-Anwendung), enthält der Bericht Empfehlungen für weitere Maßnahmen.

Die meisten Transformationen werden in mehreren Schritten durchgeführt, wobei Git verwendet wird, um dazwischenliegende Transformationen zu übernehmen. Du kannst die durch die Transformation vorgenommenen Änderungen mithilfe von Git-Standardbefehlen überprüfen:

git status
git log
git diff <original commit-id> 

Eine benutzerdefinierte Transformation erstellen

Wenn AWS verwaltete Transformationen nicht Ihren Anforderungen entsprechen, können Sie benutzerdefinierte Transformationen erstellen, die auf Ihre spezifischen Anforderungen zugeschnitten sind.

Um eine benutzerdefinierte Transformation zu erstellen

Eine ausführliche Anleitung zum Erstellen benutzerdefinierter Transformationen finden Sie unterArbeitsabläufe.

AWS Webanwendung transformieren (optional)

Die AWS Transform-Webanwendung ist eine optionale Schnittstelle zur Überwachung umfangreicher Transformationskampagnen in mehreren Repositorys. Bevor Sie die AWS Transform-Webanwendung verwenden können, muss in Ihrer Organisation eine Benutzeridentität aktiviert sein, um auf AWS Transform zugreifen zu können. Informationen zur Aktivierung von AWS Transform finden Sie unter AWS Transform einrichten.

So verwenden Sie die AWS Transform-Webanwendung:

Die Webanwendung wurde für betriebliche Abläufe entwickelt, bei denen Sie eine zentrale Überwachung der Transformationen über mehrere Codebasen hinweg benötigen.