Nexus 구성

Nexus 저장소(repo)에 빌드 아티팩트를 저장하도록 Nexus 저장소 관리자를 구성합니다.

도구 체인을 작성하면서 이 도구 통합을 구성 중이면 구성 가능한 통합 섹션에서 Nexus를 클릭하십시오.
도구 체인이 있고 이 도구 통합을 추가하는 경우 IBM Cloud 콘솔에서 메뉴 아이콘 > 플랫폼 자동화 > 도구 체인을 클릭합니다. 도구 체인 페이지에서 도구 체인을 클릭하여 해당 개요 페이지를 여십시오. 또는 앱 개요 페이지의 Continuous Delivery 카드에서 도구 체인 보기를 클릭하십시오. 그런 다음 개요를 클릭하십시오.

a. 도구 추가를 클릭하십시오.

b. 도구 통합 섹션에서 Nexus를 클릭하십시오.
Nexus 도구 통합의 이 인스턴스에 대한 이름을 입력하십시오.
도구 체인에서 Nexus 카드를 클릭할 때 열릴 Nexus 저장소의 URL을 입력하십시오.
연결할 저장소 유형을 선택하십시오.
npm 레지스트리를 선택한 경우에는 다음 단계를 따르십시오.

a. 레지스트리와 연관된 이메일 주소를 입력하십시오.

b. 레지스트리와 연관된 인증 토큰을 입력하십시오.

c. Nexus 서버의 개인용 레지스트리인 Nexus 릴리스 저장소의 URL을 입력하십시오.

d. 여러 공용 및 개인용 npm 레지스트리를 결합하는 데 사용되는 URL을 입력하십시오. 예를 들어, 이 URL은 개인용 레지스트리 및 npm 글로벌 레지스트리의 캐시 모두에 액세스할 수 있는 Nexus 서버의 가상 레지스트리의 URL일 수 있습니다.
Maven 저장소를 선택한 경우에는 다음 단계를 따르십시오.

a. 저장소와 연관된 사용자 ID를 입력하십시오.

b. 저장소와 연관된 비밀번호를 입력하십시오.

c. Nexus 서버의 개인용 릴리스 저장소인 Nexus 릴리스 저장소의 URL을 입력하십시오.

d. Nexus 서버의 개인용 스냅샷 저장소인 Nexus 스냅샷 저장소의 URL을 입력하십시오.

e. 여러 공용 및 개인용 Maven 저장소를 결합하는 데 사용되는 미러 또는 공용 저장소의 URL을 입력하십시오. 예를 들어, 이 URL은 개인용 저장소 및 Maven 중앙 저장소의 캐시 모두에 액세스할 수 있는 Nexus 서버의 가상 저장소의 URL일 수 있습니다.
통합 작성을 클릭하십시오.
도구 체인의 개요 페이지에 있는 써드파티 도구 카드에서 작업할 Nexus 저장소를 클릭하십시오. 저장소의 컨텐츠를 볼 수 있는 Nexus 웹 사이트가 열립니다.
선택사항: IBM Cloud Public에서 도구 체인을 사용 중이며 npm에서 Nexus를 사용하여 앱을 빌드하려면 npm 빌드 작업을 추가하도록 파이프라인을 구성하십시오. 빌드 작업 구성에 대한 지시사항은 파이프라인에서 Nexus npm 빌드 작업 구성 절을 참조하십시오.
선택사항: IBM Cloud Public에서 도구 체인을 사용 중이며 Maven에서 Nexus를 사용하여 앱을 빌드하려면 Maven 빌드 작업을 추가하도록 파이프라인을 구성하십시오. 빌드 작업 구성에 대한 지시사항은 파이프라인에서 Nexus Maven 빌드 작업 구성 절을 참조하십시오.

파이프라인에서 Nexus npm 빌드 작업 구성

파이프라인에서 npm 빌드 작업을 구성하려면, 우선 입력으로서 빌드 SCM 저장소를 사용할 수 있는 작업 파이프라인이 있어야 하며 도구 체인의 Nexus를 구성해야 합니다. Nexus 구성에 대한 지시사항은 Nexus 절을 참조하십시오.

npm 빌드 작업을 추가하도록 Delivery Pipeline을 구성하십시오.

단계를 작성하고 적합한 SCM 저장소에 대한 입력을 설정하십시오.
단계에서 빌드 작업을 추가하십시오.
빌드 작업 구성:

빌드

a. 빌더 유형의 경우 **npm(Artifactory 또는 Nexus)**을 선택하십시오.

b. Nexus 도구 통합의 여러 인스턴스를 구성한 경우에는 npm 빌드 작업이 구성될 Nexus 도구 통합의 이름을 입력하십시오.

c. 도구 통합 유형에 대해 Nexus를 선택하십시오.

d. 빌드 명령에 대해 npm 모듈을 빌드하거나 이를 레지스트리에 공개하는 명령을 입력하십시오. 다음 예제는 모듈을 빌드하거나 이를 공개하는 명령을 보여줍니다.
```
npm install
# or
npm publish --registry "${NPM_RELEASE_URL}"
```
Nexus 도구 통합을 위한 구성 설정의 레지스트리에 연결하는 데 사용된 URL 및 사용자 인증 정보를 찾을 수 있습니다.

e. Nexus 레지스트리로 빌드 작업이 공개되고 노드 모듈 버전의 형식이 x.y.z-SNAPSHOT.w인 경우 점진적 스냅샷 모듈 버전 선택란을 선택하십시오. 빌드 작업은 Nexus 레지스트리에 공개되기 전에 모듈 버전을 자동으로 업데이트합니다. 빌드 작업은 로컬 package.json 파일 및 npm 레지스트리에서 모듈의 최상위 버전을 선택하며 semver을 사용하여 모듈 버전을 올립니다. 빌드 작업은 변경사항을 SCM 저장소에 전달하지 않습니다.
저장을 클릭하십시오. 파이프라인이 실행될 때마다 이 빌드 작업은 Nexus 도구 통합의 구성 정보를 사용하여 npm 레지스트리에 연결합니다.

파이프라인에서 Nexus Maven 빌드 작업 구성

파이프라인에서 Maven 빌드 작업을 구성하려면, 우선 입력으로서 빌드 SCM 저장소를 사용할 수 있는 작업 파이프라인이 있어야 하며 도구 체인의 Nexus를 구성해야 합니다. Nexus 구성에 대한 지시사항은 Nexus 절을 참조하십시오.

Maven 빌드 작업을 추가하도록 Delivery Pipeline을 구성하십시오.

단계를 작성하고 적합한 SCM 저장소에 대한 입력을 설정하십시오.
단계에서 빌드 작업을 추가하십시오.
빌드 작업 구성:

빌드 작업

a. 빌더 유형의 경우 **Maven(Artifactory, Nexus, SonarQube)**을 선택하십시오.

b. Nexus 도구 통합의 여러 인스턴스를 구성한 경우에는 Maven 빌드 작업이 구성될 Nexus 도구 통합의 이름을 입력하십시오.

c. 도구 통합 유형에 대해 Nexus를 선택하십시오.

d. 빌드 명령에 대해 Maven 모듈을 빌드하거나 이를 스냅샷 레지스트리에 공개하는 명령을 입력하십시오. 다음 예제는 모듈을 빌드하거나 이를 공개하는 명령을 보여줍니다.
```
mvn -B clean package
# or
mvn -DaltDeploymentRepository="snapshots::default::${MAVEN_SNAPSHOT_URL}" deploy
```
Nexus 도구 통합을 위한 구성 설정의 레지스트리에 연결하는 데 사용된 URL 및 사용자 인증 정보를 찾을 수 있습니다.
저장을 클릭하십시오. 파이프라인이 실행될 때마다 이 빌드 작업은 Nexus 도구 통합의 구성 정보를 사용하여 Maven 저장소에 연결합니다.

API를 사용하여 Nexus 구성하기

Nexus 도구 통합은 도구 통합을 작성, 읽기및 업데이트 할 때 도구 체인 HTTP API및 SDK 와 함께 사용할 수 있는 다음 구성 매개변수를 지원합니다.

nexus 값을 사용하여 요청 본문에서 tool_type_id 특성을 지정해야 합니다.

Nexus 도구 통합 매개변수
매개변수	사용량	유형	Terraform 인수	설명
dashboard_url	선택적, 갱신 가능	문자열	Server_url	이 도구 통합에 대한 Nexus 서버 대시보드의 URL입니다. 그래픽 UI에서 Nexus 도구 통합 카드를 클릭하면 브라우저가 이 대시보드로 이동합니다.
미러 URL	선택적, 갱신 가능	문자열	미러 URL	개인용 저장소 및 공용 저장소의 캐시를 볼 수 있는 Nexus 가상 저장소의 URL입니다.
이름	필수, 갱신 가능	문자열	이름	이 도구 통합의 이름입니다.
릴리스 URL	선택적, 갱신 가능	문자열	릴리스 URL	Nexus 릴리스 저장소의 URL입니다.
스냅샷 URL	선택적, 갱신 가능	문자열	스냅샷 URL	Nexus 스냅샷 저장소의 URL입니다.
토큰	선택적, 갱신 가능	비밀번호	토큰	Nexus 저장소를 사용하여 인증하기 위한 비밀번호 또는 토큰입니다. 이 매개변수에 대해 도구 체인 시크릿 참조를 사용할 수 있습니다. 시크릿 참조에 대한 자세한 정보는 Continuous Delivery에서 민감한 데이터 보호 를 참조하십시오.
유형	필수, 갱신 가능	문자열	유형	Nexus 도구 통합을 위한 저장소 유형입니다.
user_id	선택적, 갱신 가능	문자열	user_id	Nexus 저장소로 인증하기 위한 사용자 ID 또는 이메일 주소입니다.