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 플래그가 있는 구성: 키-값, 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

폐기 결과

재분석은 해결된 결과를 더 이상 사용되지 않는 것으로 표시합니다. 다시 열 수 없습니다. 감사용으로 보관됩니다.

문제 해결 생성

결과 기반, 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 branch.

참고

토큰에는 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 변환 웹 애플리케이션은 코드 소스 포트폴리오 전반에서 지속적인 현대화 분석, 조사 결과 및 문제 해결을 모니터링하기 위한 선택적 인터페이스입니다.

AWS 변환 웹 애플리케이션을 사용하기 전에 조직의 AWS 변환에 액세스하려면 사용자 자격 증명이 활성화되어 있어야 합니다. AWS 변환 활성화에 대한 자세한 내용은 AWS 변환 설정을 참조하세요.

AWS 변환 웹 애플리케이션을 사용하려면:

  1. https://aws.amazon.com/transform/를 방문하여 AWS IAM Identity Center 자격 증명을 사용하여 로그인합니다.

  2. 로그인한 후 지속적인 현대화가 나타나지 않으면 대신 IAM 자격 증명으로 로그인합니다. IAM 자격 증명 로그인을 활성화하려면:

    1. AWS 관리 콘솔에서 AWS 변환을 열고 설정을 선택합니다.

    2. IAM 자격 증명을 사용한 액세스 AWS 변환 섹션에서 IAM 자격 증명 액세스를 활성화합니다.

    3. 동일한 설정 페이지에서 웹 애플리케이션 URL(IAM 사용) 아래에 표시된 로그인 링크를 복사합니다.

    4. Management Console이 열려 있는 동일한 브라우저 창에 로그인 URL을 AWS 붙여 넣습니다. 이렇게 하면 웹 애플리케이션이 해당 계정의 AWS 자격 증명을 사용할 수 있습니다.

  3. 왼쪽 탐색 메뉴를 열고 지속적 현대화를 선택합니다. 대시보드에는 소스, 리포지토리, 심각도별 총 조사 결과 및 분석 유형을 포함한 요약 통계가 표시됩니다.

  4. 분석, 결과 및 문제 해결 탭을 사용하여 자세한 결과를 볼 수 있습니다.

  5. 웹 애플리케이션에서 직접 AWS 변환과 채팅하여 분석, 조사 결과 또는 문제 해결에 대해 질문합니다.

웹 애플리케이션은 여러 코드베이스에서 지속적인 현대화 분석 및 문제 해결을 중앙 집중식으로 파악해야 하는 엔터프라이즈 규모의 운영을 위해 설계되었습니다.