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 custom 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 Internetzugriff arbeiten, aktualisieren Sie die Firewallregeln, um diese URLs auf die Zulassungsliste zu setzen.

Installieren von AWS CLI transformieren

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

So installieren Sie die AWS Transform CLI

Konfigurieren der Authentifizierung

AWS Für die benutzerdefinierte Transformation sind AWS Anmeldeinformationen erforderlich, 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 den Anmeldeinformationen

Konfigurieren Sie die Anmeldeinformationen in der AWS Anmeldeinformationsdatei, die sich ~/.aws/credentials unter Linux und macOS oder %USERPROFILE%\.aws\credentials unter Windows befindet:

[default]
aws_access_key_id = your_access_key
aws_secret_access_key = your_secret_key

IAM-Berechtigungen

Ihre AWS Anmeldeinformationen müssen über Berechtigungen zum Aufrufen des benutzerdefinierten AWS Transform-Dienstes verfügen. Wir empfehlen, die AWSTransformCustomFullAccess AWS verwaltete Richtlinie Ihrem IAM-Benutzer oder Ihrer IAM-Rolle zuzuordnen. Diese Richtlinie gewährt vollen Zugriff auf AWS Transform custom, einschließlich der Erlaubnis, die serviceverknüpfte Rolle zu erstellen, die für die Übertragung von CloudWatch Metriken an Ihr Konto erforderlich ist.

Für eine detailliertere Kontrolle 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. Benutzerdefinierte IAM-Richtlinien mit Berechtigungen auf Ressourcenebene finden Sie im Referenzhandbuch zur AWS Transform Custom IAM Service Authorization.

Konfigurieren AWS Region

AWS Transform Custom ist in bestimmten AWS Regionen verfügbar und erkennt Ihre Regionskonfiguration automatisch unter Verwendung 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 bestimmen, welche Region verwendet werden soll:

Deine Region festlegen

Wählen Sie eine der folgenden 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 eine 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"

Detaillierte Regionsauflösung in Debug-Protokollen anzeigen:

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 verwendet werden können.

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

Ausführliche Informationen zu Ausführungsmodi, Konfigurationsoptionen und Befehlsflags finden Sie unter. Befehlsreferenz

Transformationsergebnisse verstehen

Wenn eine Transformation abgeschlossen ist, stellt AWS Transform custom einen Bericht zur Verfügung, 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 Zwischenschritte zu übertragen. Sie können die durch die Transformation vorgenommenen Änderungen mit Standard-Git-Befehlen überprüfen:

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

Eine benutzerdefinierte Transformation erstellen

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

Um eine benutzerdefinierte Transformation zu erstellen

Ausführliche Anweisungen zum Erstellen benutzerdefinierter Transformationen finden Sie unterArbeitsabläufe.

AWS Webanwendung transformieren (optional)

Die AWS Transform-Webanwendung ist eine optionale Schnittstelle für die Überwachung umfangreicher Transformationskampagnen in mehreren Repositorys. Bevor Sie die AWS Transform-Webanwendung verwenden können, müssen Sie eine Benutzeridentität aktiviert haben, um in Ihrer Organisation 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 Unternehmensabläufe konzipiert, bei denen Sie eine zentrale Überwachung der Transformationen über mehrere Codebasen hinweg benötigen.