View a markdown version of this page

継続的なモダナイゼーションの使用 - AWS 変換
ソース管理リポジトリの検出と管理分析の実行検出結果の管理修復の作成AWS ウェブアプリケーションの変換 (オプション)

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

継続的なモダナイゼーションの使用

ソース管理

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

GitHub 組織

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

atx ct source add --name name --provider github --org org --token pat

GitLab グループとユーザー

トークン: 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 ワークスペースとプロジェクト

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

ローカルリポジトリ

atx ct source add --name name --provider local --path parent-directory
重要

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

ソースの管理

atx ct source list
atx ct source remove --name name

リポジトリの検出と管理

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"

分析の実行

--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]

カスタム分析

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

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

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

検出結果の管理

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

検出結果のステータス

  • 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

廃止の検出

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

修復の作成

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 ウェブアプリケーションの変換 (オプション)

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

AWS 変換ウェブアプリケーションを使用する前に、組織内の AWS 変換にアクセスするためのユーザー ID を有効にする必要があります。 AWS 変換を有効にする方法については、AWS 「変換の設定」を参照してください。

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

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

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

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

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

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

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

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

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

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

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