

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 継続的なモダナイゼーションの使用
<a name="ct-working-with"></a>

## ソース管理
<a name="ct-source-management"></a>

`atx ct source` コマンドを使用してリポジトリを接続します。サポートされているプロバイダー: GitHub、GitLab、Bitbucket、local。

### GitHub 組織
<a name="ct-source-github"></a>

トークン: `repo`スコープを持つ個人用アクセストークン (クラシック）。分析には読み取り専用、修復には完全なリポジトリ。

```
atx ct source add --name {{name}} --provider github --org {{org}} --token {{pat}}
```

### GitLab グループとユーザー
<a name="ct-source-gitlab"></a>

トークン: `api`スコープを持つ個人用アクセストークン。

```
atx ct source add --name {{name}} --provider gitlab --org {{group-or-user}} --token {{pat}}
# Self-hosted:
atx ct source add --name {{name}} --provider gitlab --org {{group-or-user}} --token {{pat}} --url https://{{gitlab.example.com}}
```

### Bitbucket ワークスペースとプロジェクト
<a name="ct-source-bitbucket"></a>

Bitbucket Cloud — スコープ: `read:repository:bitbucket`、`write:repository:bitbucket`、`read:pullrequest:bitbucket`、`write:pullrequest:bitbucket`。また、 `--email`と も必要です`--username`。

```
atx ct source add --name {{name}} --provider bitbucket --org {{workspace}} --token {{api-token}} --email {{email}} --username {{username}}
```

Bitbucket データセンター:

```
atx ct source add --name {{name}} --provider bitbucket --org {{project-key}} --token {{http-access-token}} --url https://{{bitbucket.example.com}}
```

### ローカルリポジトリ
<a name="ct-source-local"></a>

```
atx ct source add --name {{name}} --provider local --path {{parent-directory}}
```

**重要**  
`--path` は、単一のリポジトリではなく、git リポジトリをサブディレクトリとして含む親ディレクトリを指す必要があります。

### ソースの管理
<a name="ct-managing-sources"></a>

```
atx ct source list
atx ct source remove --name {{name}}
```

## リポジトリの検出と管理
<a name="ct-repository-discovery"></a>

```
atx ct discovery scan --source {{name}}
atx ct discovery status --source {{name}}
atx ct discovery scan --source {{name}} --path {{new-directory}}
```

検出後:

```
atx ct repository list
atx ct repository list --source {{name}}
atx ct repository list --labels "{{team:frontend,priority:high}}"
atx ct repository update --source {{name}} --repo "{{source}}::{{slug}}" --labels "{{team:frontend,priority:high}}"
atx ct repository update --source {{name}} --labels "{{migration:wave-1}}"
```

## 分析の実行
<a name="ct-running-analysis"></a>

`--type` フラグは、実行する分析の種類を指定します。
+ `rapid-techdebt-analysis` – 古い依存関係と簡単な成功。
+ `tech-debt-comprehensive` – 依存関係、セキュリティ、パターン、パフォーマンス、保守性、アーキテクチャ、コード品質、インフラストラクチャの検出結果をカバーする、より詳細な AI を活用した分析。
+ `security` – セキュリティの脆弱性と露出。
+ `agentic-readiness` – AI エージェント用のリポジトリの準備状況 (フレームワーク、APIs、ドキュメント）。
+ `modernization-readiness` – インフラストラクチャ、アプリケーション、データ、セキュリティ、運用の各側面にわたるモダナイゼーションの機会。

```
atx ct analysis run --type {{type}} --source {{name}} [--repo {{source}}::{{slug}}] [--wait]
atx ct analysis get --id {{id}} --json
atx ct analysis list --json
atx ct analysis list --status {{pending|running|complete|cancelled|failed}} --json
atx ct analysis list --type {{type}} --json
atx ct analysis cancel --id {{id}}
atx ct analysis delete --id {{id}} [--cascade-findings]
```

### カスタム分析
<a name="ct-custom-analysis"></a>

```
atx ct analysis run --type custom --transformation-name {{name}} --source {{source}} --repo {{source}}::{{slug}} --wait
```

`-g` フラグ付き設定: key-value、JSON、またはファイルパス。

TDs一覧表示する: `atx custom def list`

## 検出結果の管理
<a name="ct-managing-findings"></a>

```
atx ct findings list --json
atx ct findings list --repo {{source}}::{{slug}} --source {{name}} --severity {{high|medium|low}} --type {{analysis-type}} --status {{open|dismissed|obsolete}} --analysis-id {{id}} --fix-transform {{transform-name}} --json
```

### 検出結果のステータス
<a name="ct-finding-statuses"></a>
+ `open` — アクティブ
+ `dismissed` — 手動で却下 (理由が必要)
+ `obsolete` — 再分析で結果が生成されなくなった場合のシステムセット

```
atx ct findings update --id {{id}} --status dismissed --reason "{{reason}}"
atx ct findings update --id {{id}} --status open
atx ct findings batch-update --ids {{id1}},{{id2}} --status dismissed --reason "{{reason}}"
atx ct findings get --id {{id}}
atx ct findings delete --id {{id}}
```

### 廃止の検出
<a name="ct-finding-obsolescence"></a>

再分析では、解決された検出結果は古いものとしてマークされます。再度開くことはできません。監査のために保持されます。

## 修復の作成
<a name="ct-creating-remediations"></a>

3 つのモード: 検出結果ベース、TD オーバーライド、直接 TD。

```
atx ct remediation create --ids {{id1}},{{id2}} --name "{{name}}"
atx ct remediation create --ids {{id1}},{{id2}} --transformation-name {{TD}}
atx ct remediation create --transformation-name {{TD}} --repo {{source}}::{{slug}}
```

プロバイダー別の出力: GitHub PR、GitLab MR、Bitbucket PR、Local ブランチ。

**注記**  
トークンには、PR/MR 作成用の書き込みアクセス権が必要です。

`--local` フラグ付きのローカル実行。

```
atx ct remediation create --transformation-name {{TD}} --repo {{source}}::{{slug}} -g "{{additionalPlanContext=Upgrade to Node.js 22}}"
atx ct remediation list
atx ct remediation status --id {{id}}
atx ct remediation retry --id {{id}}
atx ct remediation delete --id {{id}}
```

## AWS ウェブアプリケーションの変換 (オプション)
<a name="ct-web-application"></a>

 AWS Transform ウェブアプリケーションは、コードソースのポートフォリオ全体で継続的なモダナイゼーション分析、検出結果、修復をモニタリングするためのオプションのインターフェイスです。

 AWS 変換ウェブアプリケーションを使用する前に、組織内の AWS 変換にアクセスするためのユーザー ID を有効にする必要があります。 AWS 変換を有効にする方法については、[AWS 「変換の設定](https://docs.aws.amazon.com/transform/latest/userguide/transform-setup.html)」を参照してください。

 AWS Transform ウェブアプリケーションを使用するには:

1.  AWS IAM Identity Center 認証情報を使用して にアクセスしてサインイン`https://aws.amazon.com/transform/`します。

1. サインイン後に継続的なモダナイゼーションが表示されない場合は、代わりに IAM 認証情報を使用してサインインします。IAM 認証情報のサインインを有効にするには:

   1.  AWS マネジメントコンソールで、 AWS 変換を開き、**設定**を選択します。

   1. **「IAM 認証情報を使用したアクセス AWS 変換**」セクションで、IAM 認証情報アクセスを有効にします。

   1. 同じ設定ページで、**ウェブアプリケーション URL (IAM を使用) **の下に表示されるサインインリンクをコピーします。

   1. サインイン URL を、 マネジメントコンソールが開いているのと同じブラウザウィンドウに貼り付けます AWS 。これにより、ウェブアプリケーションはそのアカウントの AWS 認証情報を使用します。

1. 左側のナビゲーションメニューを開き、**継続的なモダナイゼーション**を選択します。ダッシュボードには、ソース、リポジトリ、重要度別の検出結果の合計、分析タイプなどのサマリー統計が表示されます。

1. 詳細な結果を表示するには、**分析**、**結果**、**修復タブ**を使用します。

1. とチャットする ウェブアプリケーションから直接 AWS 変換して、分析、検出結果、または修復について質問します。

ウェブアプリケーションは、複数のコードベースにわたる継続的なモダナイゼーション分析と修復を一元的に可視化する必要があるエンタープライズ規模のオペレーション向けに設計されています。