기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 지속적인 현대화 작업
<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` 플래그가 있는 구성: 키-값, 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>

결과 기반, 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 웹 애플리케이션 변환(선택 사항)
<a name="ct-web-application"></a>

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

 AWS 변환 웹 애플리케이션을 사용하기 전에 조직의 AWS 변환에 액세스하려면 사용자 자격 증명이 활성화되어 있어야 합니다. AWS 변환 활성화에 대한 자세한 내용은 [AWS 변환 설정을 참조하세요](https://docs.aws.amazon.com/transform/latest/userguide/transform-setup.html).

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

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

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

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

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

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

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

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

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

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

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