설정 정보 생성

칵테일 클라우드는 설정 정보로서 ConfigMap과 Secret 유형을 제공합니다.

어떤 유형의 설정 정보를 제공하나요?

• ConfigMap: ConfigMap은 컨테이너에 설정 데이터를 주입하기 위한 쿠버네티스 객체입니다.

• Secret: Secret은 암호, 토큰, 키값 등 민감한 데이터를 포함하는 쿠버네티스 객체로서, 쿠버네티스에서는 Docker-registry, generic, tls 유형을 정의하고 있습니다. 칵테일 클라우드는 이 모든 유형을 지원합니다.

설정 정보 관리의 특장점은 무엇인가요?

설정 정보 설정 및 이용의 용이성

사용자가 설정 정보 관리 메뉴에서 Key-Value 형태로 사용할 설정 정보를 생성해 놓으면, 나중에 컨테이너 설정 시 선택 박스에서 간편하게 컨테이너에서 사용할 설정 정보를 선택할 수 있습니다.

태스크 목록

• ConfigMap 생성

• Secret 생성

• 설정 정보 조회

• 워크로드에서 설정 정보 사용

1. ConfigMap 생성

1.1 설정 정보 화면으로 이동

1) [애플리케이션] - [서비스 맵] 탭으로 이동한 후 설정 정보를 선택하여 "+ 생성" 버튼을 클릭 후 컨피그 맵을 선택합니다.

[화면] 서비스 맵의 설정 정보 화면 접근

1.2 기본 정보 입력

1) 컨피그 맵의 이름과 설명, 라벨과 주석 정보를 입력합니다.

[화면] 컨피그 맵 기본 정보 입력

항목(*는 필수)	내용
이름*	생성할 컨피그 맵 이름을 입력 (대문자, 소문자, 숫자, 특수문자(-.)만 사용 가능)
설명	생성할 컨피그 맵에 대한 설명을 입력
라벨	컨피그 맵에 작성할 라벨을 입력
주석	컨피그 맵에 원하는 주석을 입력

1.3 키-값 정보 입력

1) 컨피그 맵 정보 입력 화면에서 하단 데이터 섹션 우측의 "+추가" 버튼을 클릭하여 키-값 정보를 입력 후 "적용"합니다. 해당 컨피그 맵에서 여러 개의 키-값 정보를 관리할 경우, 필요한 개수 만큼 키-값 정보 입력 작업을 반복하면 됩니다.

[화면] 컨피그 맵의 키-값 정보 입력

• KEY 필드는 필수 입력 항목 입니다.

1.4 저장

1) 컨피그 맵 정보 입력 후 이를 실제로 생성하기 위해서는 "저장" 버튼을 클릭합니다.

2. Secret 생성

2.1 설정 정보 화면으로 이동

1) [애플리케이션] - [서비스 맵] 탭으로 이동한 후 설정 정보를 선택하여 "+ 생성" 버튼을 클릭 후 시크릿을 선택합니다.

[화면] 서비스 맵의 설정 정보 화면 접근

2.2 기본 정보 입력

[화면] 시크릿 기본 정보 입력

항목(*는 필수)	내용
이름*	생성할 컨피그 맵 이름 입력 (대문자, 소문자, 숫자, 특수문자(-.)만 사용 가능)
설명	생성할 컨피그 맵에 대한 설명 입력
유형	Generic: DockerRegistry: TLS: 공인인증서 등록을 위한 인증서
라벨	컨피그 맵에 작성할 라벨 입력
주석	컨피그 맵에 원하는 주석 입력

2.3 키-값 정보 입력

1) 시크릿 정보 입력 화면에서 하단 데이터 섹션 우측의 "+" 버튼을 클릭하여 키-값 정보를 입력합니다. 해당 시크릿에서 여러 개의 키-값 정보를 관리할 경우, 필요한 개수만큼 키-값 정보 입력 작업을 반복하면 됩니다.

[화면] 시크릿의 키-값 정보 입력

• KEY 필드는 필수 입력 항목 입니다.

2.4 저장

1) 시크릿 정보 입력 후 이를 실제로 생성하기 위해서는 저장 버튼을 클릭합니다.

2.5 imagePullSecrets 생성

기존에 칵테일에서 강제로 생성하여 할당하던 imagePullSecrets 처리는 더 이상 사용되지 않으며, 사용자가 목적에 맞게 imagePullSecrets을 바로 생성하여 워크로드에서 사용할 수 있습니다.

( imagePullSecrets은 Kubernetes Secret 형태로 제공되는 인증 토큰이며, Private 레지스트리에 액세스하는 데 사용되는 Docker 인증 정보를 저장하고 있습니다. )

1) [애플리케이션] - [서비스 맵] 탭에서 시크릿을 생성할 서비스 맵을 선택한 후 설정정보로 이동하여 "+ 생성" 버튼을 클릭합니다.

[화면] 시크릿 생성

2) "시크릿"을 클릭합니다.

[화면] 시크릿 정보 입력

항목(*는 필수)	내용
이름*	생성할 시크릿 명을 입력
설명	시크릿에 대한 설명 작성
유형*	도커 레지스트리로부터 이미지를 가져오기 위해 인증 정보를 저장하고 있는 DockerRegistry를 선택
라벨	Key / value 값으로 지정되며 해당 정보로 정보 식별 가능
주석	특별한 기능은 없지만 부연 설명으로 사용
설정 유형*	직접입력 : 레지스트리 인증 정보 직접 작성 레지스트리에서 선택: 기존에 등록해 놓은 레지스트리 선택
레지스트리	기존에 등록해 놓은 레지스트리 중 선택

3. 설정 정보 조회

3.1 설정 정보 목록 조회

1) [애플리케이션] - [서비스 맵] 탭으로 이동한 후 설정 정보를 선택하여 설정 정보의 목록을 조회합니다.

[화면] 설정 정보 목록 조회

3.2 설정 정보 상세 정보 조회

1) 설정 정보의 이름을 선택하면 해당 설정 정보를 확인할 수 있습니다.

[화면] 설정 정보 상세 조회

2) 설정 정보의 상세 정보를 YAML 형식으로 조회할 수도 있습니다. 상기 화면 우측 상단의 설정 탭으로 이동 후 표시되는 화면에서 좌측 상단의 설정 보기를 "YAML 보기"로 선택하면 YAML 형식의 정보가 표시됩니다.

[화면] 설정 정보 YAML 포맷 조회

4. 워크로드에서 설정 정보 사용

1) 설정 정보를 사용할 워크로드 선택 후 설정 탭으로 이동하면 워크로드 상세 설정 화면이 표시됩니다.

[화면] 워크로드 상세 설정 화면

4.1 컨테이너에서 환경 변수 설정

1) 컨테이너 명 선택 후 [환경 변수] 탭으로 이동합니다.

[화면] 컨테이너 환경 변수 설정 화면

2) 사용하고자 하는 설정 정보의 유형을 선택합니다.

컨피그 맵 값을 선택하거나 시크릿 값을 선택하였을 경우, 간단하게 사용하려는 설정 정보 리소스 및 설정 정보 리소스가 포함하는 키값을 선택할 수 있습니다. 컨테이너에서 선택한 설정 정보 키-값을 접근할 환경 변수 키값을 별도로 입력한 후, "적용" 버튼을 클릭합니다.

[화면] 설정 정보 선택 및 환경 변수 키 값 입력

• 직접 입력, 컨피그 맵 값, 시크릿 값, Field Ref, Resource Field Ref 항목의 KEY, VALUE 필드는 필수 입력값입니다.

4.2 워크로드 재시작

1) 환경 변수가 효력을 발휘하기 위해서는 컨테이너의 재시작이 필요합니다. 워크로드 상세 설정 화면 상단 우측의 "저장 후 시작" 버튼을 클릭하여 재기동시킵니다.

4.3 환경 변수 적용 확인

터미널 내용 포함 예정

1) 워크로드 상세 배포 정보 조회 화면에서 환경 변수를 적용한 컨테이너를 찾은 후, 오른쪽 터미널 아이콘을 클릭합니다. 터미널 아이콘을 클릭하면 해당 컨테이너에 대한 대화형 쉘이 화면에 표시됩니다. 대화면 쉘에서 env 명령어를 표시하여, 환경 변수의 내용이 올바르게 설정되어 있는지 확인합니다.