환경에 모듈 설치하기

모듈 설치는 제품 목록과 구성을 환경에 적용하는 작업입니다. 새 개체를 만들 수도 있고, 이미 설치된 개체를 모듈 관리에 편입할 수도 있으므로 변경 요청의 실제 영향을 확인해야 합니다.

설치 시작

Software Catalog에서 모듈을 열고 Actions → Install module을 선택합니다.

배포 환경 화면의 Actions → Install module에서도 시작할 수 있습니다.

모듈과 환경 선택

설치할 모듈과 대상 환경을 선택합니다. 설치본을 구분하기 위한 표시 이름을 선택적으로 지정하고 Next를 선택합니다.

표시 이름과 실제 모듈, 환경 및 설치본의 식별자는 구분합니다. 이미 설치본이 있다면 새 대상을 만들려는지 기존 설치본을 갱신하려는지 확인해야 합니다. 기존 설치본의 수동 갱신은 업데이트 화면에서 시작하여 대상을 명확히 하는 편이 좋습니다.

변수와 비밀정보 구성

모듈에 변수가 있으면 설치본에 사용할 값을 지정합니다. 필요한 비밀정보도 이 단계에 표시되며 Edit Secrets로 값을 제공합니다.

요구된 비밀정보가 이미 존재하면 같은 값을 다시 만들 필요는 없습니다. 새로 필요한 비밀정보는 설치 요건에 맞게 준비합니다.

Preview module contents에서 각 배포 개체에 적용할 구성을 확인할 수 있습니다.

변경 요청과 결과 확인

Install을 선택하면 환경에 모듈을 설치하는 변경 요청이 생성됩니다. 변경 요청에서 새 설치와 기존 구성 변경의 범위를 확인합니다.

설치 후 환경의 Entities 탭에서 대상을 확인합니다. Modules 열은 해당 개체가 어느 모듈에 속하는지 보여줍니다.

기존 배포 개체를 모듈로 관리

모듈 정의의 배포 개체와 환경에 있는 개체의 Entity ID가 같으면, 새 대상을 만드는 대신 기존 대상을 모듈 관리로 편입할 수 있습니다.

가상의 모듈에 31개 개체가 있고 그중 30개가 이미 같은 ID로 환경에 설치되어 있다면, 모듈 설치로 나머지 하나를 새로 설치하고 기존 30개도 모듈이 관리하게 할 수 있습니다.

기존 구성값을 유지할지 변경할지는 설정 동기화 방식에 따라 달라집니다.

모듈 연결 해제

모듈 화면의 Installations에서 대상 설치본을 선택하고 Unlink module을 선택합니다.

연결을 해제하면 환경에서 모듈 설치 관계가 제거됩니다. 모듈에 속했던 배포 개체는 환경에 남지만 더 이상 그 모듈이 관리하지 않습니다.

이 동작은 개체의 설치 제거가 아니며, Apollo 환경 설정에서 개체 자체를 제외하는 관리 해제와도 구분합니다.