AWS CodeConnections を使用してリポジトリに接続する Personal Access Token を使用してリポジトリに接続する Amazon S3 のソースコードに接続する

ソースコードに接続する

の後に.NET モダナイゼーションジョブを作成する、ジョブプランタブで、 AWS 変換ウィンドウの左ペインに変換ジョブのフェーズが一覧表示されます。最初のフェーズは Connect ソースコードです。このフェーズでは、ソースコードに接続します。

開始する前に、ソースコード接続を作成するアクセス許可を持つ AWS アカウントがあることを確認してください。選択した接続方法に応じて、 AWS CodeConnections、 AWS Secrets Manager に保存されている個人用アクセストークン (PAT)、または変換ジョブと同じ AWS リージョンの Amazon S3 バケットへのアクセスも必要です。コネクタを作成するには、 AWS 管理者の承認が必要です。

ソースコードリポジトリに接続するか、zip ファイルでコードを提供できます。ソースコードに接続するための 4 つのオプションがあります。

コード接続: AWS CodeConnections (GitHub、GitLab、Bitbucket、Azure DevOps) を使用してソースコードリポジトリに接続します。
PAT: AWS Secrets Manager に保存されている個人用アクセストークンを使用してソースコードリポジトリに接続します。
S3: コードアーカイブ zip ファイル ( など) に Amazon S3 URI を指定しますs3://my-bucket/repos.zip。
直接アップロード: コードアーカイブ zip ファイルをチャットペインにドラッグアンドドロップします。

コード接続方法を選択すると、エージェントがセットアップを案内します。

AWS CodeConnections を使用してリポジトリに接続する

コード接続オプションを選択した場合、 AWS 変換エージェントは AWS CodeConnections を使用して Azure Repos、Bitbucket、GitHub、または GitLab から .NET コードベースをダウンロードします。変換されたコードは、新しい書き込み可能なブランチに書き込まれます。 AWS 変換ジョブと同じリージョンに AWS CodeConnections を設定する必要があります。

注記

既存のソースコードリポジトリコネクタがある場合、 AWS Transform から通知されます。既存のコネクタを使用してこのコネクタを使用するを選択します。既存のコネクタを使用しない場合は、既存のコネクタの削除の前にを参照してください新しいコネクタの追加。ジョブごとに 1 つのソースリポジトリコネクタのみを持つことができます。

新しいコネクタの追加

新しいソースコードリポジトリコネクタを作成するには:

AWS CodeConnections コネクタに使用する AWS アカウント番号を入力します。
同じ AWS アカウントに AWS CodeConnections を設定していない場合は、AWS CodeConnections を設定します。
AWS デベロッパーツールコンソールを使用して、Bitbucket、GitHub、GitHub Enterprise Server、GitLab、または AzureDevOps リポジトリへの接続を作成します。
作成した接続の Amazon リソースネーム (ARN) をコピーします。
AWS 変換に戻り、作成した接続の ARN を貼り付けます。
コネクタの名前を入力します。

注記
コネクタ名の一部として個人情報を入力しないでください。
コネクタの作成を開始するを選択します。
AWS Transform は、現在の変換ジョブと同じリージョンに、入力した AWS アカウントのコネクタを作成するリクエストを行い、承認リクエストが AWS マネジメントコンソールで AWS 管理者によって承認される準備ができていることを通知します。検証リンクをコピーを選択します。
AWS 管理者の場合は、 AWS アカウントにサインインし、検証リンクに移動して接続リクエストを承認します。 AWS 管理者でない場合は、検証リンクを AWS 管理者に提供します。
AWS 管理者がコネクタリクエストを承認したら、コネクタを確定を選択してコネクタ作成プロセスを完了します。別のコネクタを使用する場合は、再起動を選択してコネクタ作成プロセスを再起動します。

コラボレーションタブには、以下を含むコネクタの詳細も含まれています。

ステータス -- 承認済みまたは保留中の承認
AWS アカウント ID
AWS リージョン
接続 ARN

既存のコネクタの削除

注記

既存のソースコードリポジトリコネクタがある場合、 AWS Transform から通知されます。既存のコネクタを使用するか、削除を選択して新しいコネクタを作成します。

既存のソースコードリポジトリ接続を削除する場合、 AWS Transform はコネクタを実際に削除する前に警告します。

既存のコネクタは、いくつかの方法で削除できます。
1. AWS Transform からプロンプトが表示された場合は、削除を選択して新しいコネクタを作成できます。
2. プロンプトで再起動を選択することもできます。このコネクタを変更するには、再起動する必要があります。
AWS Transform は、再起動するとコネクタが削除されることを警告します。コネクタを削除するには、再起動を再度選択します。
AWS Transform は、コネクタを削除すると Bitbucket、GitHub、GitLab などのサードパーティーリポジトリへの接続が削除されることを再度警告します。また、このコネクタを使用している AWS 変換ジョブは、コネクタが削除されると失敗します。削除を確認するには、「削除」と入力し、「削除」を選択します。
新しいソースコードリポジトリコネクタを追加するには、「」を参照してください新しいコネクタの追加。

Personal Access Token を使用してリポジトリに接続する

Personal Access Token (PAT) を使用してリポジトリに接続できます。以下の手順に従ってください。

エージェントがソースコード接続を求められたら、チャットペインで PAT を選択します。
PAT の生成と AWS Secrets Manager への保存に関する説明をお読みください。
ソースコントロールから PAT を生成します。
PAT を AWS Secrets Manager に保存し、Amazon リソースネーム (ARN) を記録します。たとえば、GitHub トークンは次のようにフォーマットされます。
```
github_pat_XXXXXXXXXXXXXXX
```
チャットで、コネクタのセットアップリンクを選択してコネクタフォームを開きます。
コネクタフォームに、コネクタ名、 AWS アカウント ID、シークレット ARN、およびオプションで KMS キー ARN を入力します。次に、フォームを送信します。
エージェントは承認リンクを提供します。リンクをコピーし、管理者に送信して接続を承認します。承認後、エージェントを続行します。

Amazon S3 のソースコードに接続する

ソースコードリポジトリを接続する代わりに、Amazon S3 で AWS Transform をソースコードに接続できます。 AWS CodeConnections を使用してリポジトリに接続する

S3 バケットの整理

元のソースコードと変換されたコードは、次に示すように整理された共通の S3 バケットに保存されます。 AWS 変換ジョブと同じリージョンに S3 バケットを設定する必要があります。ソースコードをルートレベルで zip ファイルとしてバケットにアップロードします。zip ファイルには、各リポジトリの最上位フォルダが含まれている必要があります。

変換中、 AWS Transform は変換出力フォルダを作成し、変換結果をそのフォルダに保存します。変換は、変換されたコードを含む transformed-code.zip という名前の zip ファイルを作成します。これには、プロジェクトレベルでファイルの変更を強調表示するコード違いレポートファイル名 diff.txt が含まれます。



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

新しい S3 コネクタの追加

新しい S3 ソースコードリポジトリコネクタを作成するには:

AWS コンソールで、S3 バケットを作成します。
ソースコードを zip ファイルとして S3 バケットにアップロードします。
AWS 変換ウェブアプリケーションで、.NET 変換ジョブを開始します。ソースコードリポジトリの接続ステップで、S3 バケットでソースコードを接続する」を選択し、「保存」を選択します。
次のページで、S3 バケットの詳細を入力し、送信を選択します。
1. コネクタ名
2. AWS アカウント ID
3. S3 バケット ARN
4. S3 バケット暗号化キー (オプション)
コネクタを承認します。
1. 次のページで、検証リンクをコピーします。
2. 承認者にリンクを参照させ、 AWS 変換コネクタの作成リクエストページにアクセスします。
3. 新しいロールを作成するか、既存のロールを使用するかを選択します。
4. リクエストを確認したら、保存と承認を選択して承認します。
S3 zip ファイルの場所を指定します。
1. ウェブアプリの AWS 変換で、ステータスが「承認済み」と表示されるのを待ちます。
2. アセットの場所を指定ページで、コード zip ファイルの S3 URL を形式で入力s3://bucket-name/zip-file-nameし、変換に送信を選択します AWS 。
3. ジョブは Discovery ステップに進み、変換を続行します。

S3 コネクタの削除

既存の S3 コネクタを削除するには:

ウェブアプリの AWS 変換で、右上にあるコネクタの管理を選択します。
コネクタの管理ウィンドウで、コネクタを選択します。
[削除] を選択します。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

.NET ジョブを作成する

リポジトリの検出