> For the complete documentation index, see [llms.txt](https://cocktailcloud.gitbook.io/cocktail-cloud-online/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cocktailcloud.gitbook.io/cocktail-cloud-online/start/workspace.md).

# 워크스페이스 만들기

작업 공간인 워크스페이스(Workspace)는 클러스터 자원을 할당받아 애플리케이션을 빌드, 배포, 운영하는 공간입니다. 보통 팀 단위로 만듭니다.

## 1. 워크스페이스 생성

1\) \[설정] - \[워크스페이스] 탭에서 우측 상단의 "+ 생성" 버튼을 클릭합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FCfmEVKGtoSpZ30wXOKZG%2Fimage.png?alt=media&amp;token=366ceddf-b08d-4b13-a333-431bb283f8fc" alt=""><figcaption><p>[화면] 워크스페이스 생성 화면</p></figcaption></figure>

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FtWJaP3adMiTw7ps0ckE2%2Fimage.png?alt=media&amp;token=0c002645-8995-4d88-906c-1adc72114d28" alt="" width="563"><figcaption><p>[화면] 워크스페이스 생성 화면의 기본 정보 폼</p></figcaption></figure>

3\) 워크스페이스 생성 화면의 기본 정보 폼에서 이름 속성에 워크스페이스 이름을 입력합니다.

4\) 색상 속성에서 워크스페이스의 색상을 선택합니다.

{% hint style="info" %}

* 워크스페이스의 색상은 화면의 ‘상단 바(Top Bar)’에 적용됩니다.
  {% endhint %}

5\) 설명 속성에 워크스페이스의 설명을 입력합니다.

## 2. 레지스트리 등록

1\) 워크스페이스 화면의 목록에서 생성된 워크스페이스명을 선택합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2F1QlMgqh9P4mz7ZIDozFh%2Fimage.png?alt=media&amp;token=933c3c09-625f-4007-8226-0b86e7236bc1" alt=""><figcaption><p>[화면] 생성된 워크스페이스 명 클릭 후 화면</p></figcaption></figure>

2\) 기본 정보 하단의 이미지 레지스트리 오른쪽 아이콘을 클릭합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2Fgit-blob-a6100420dbc561fe686b3d690f3266c3f1acb97f%2Fimage.png?alt=media" alt="" width="546"><figcaption><p>[화면] 이미지 레지스트리 화면</p></figcaption></figure>

3\) 앞서 생성한 레지스트리를 선택하고 "적용" 버튼을 클릭합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2F6vaLtUxvNCduCAQWXK5o%2Fimage.png?alt=media&amp;token=cb7dfd4c-997b-4055-a7e8-15437d80fd6f" alt=""><figcaption><p>[화면] 이미지 레지스트리 등록 확인 화면</p></figcaption></figure>

3\) 등록한 레지스트리를 확인합니다.

## 3. 클러스터 할당/제거

### 3.1 클러스터 할당

1\) 워크스페이스 화면의 목록에서 생성된 워크스페이스 명을 선택합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FuPl7XnJdPS8b41Gbtw5L%2Fimage.png?alt=media&amp;token=5b3f6c54-be78-49c0-9ffa-5ca4247a3ab9" alt=""><figcaption><p>[화면] 생성된워크스페이스 명 클릭 후 화면</p></figcaption></figure>

2\) 할당 된 클러스터 우측의 "클러스터 할당/제거" 버튼을 클릭하면, 클러스터 할당/제거 창이 나타납니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FDcjSQ2hO9WnBymlGyWYL%2Fimage.png?alt=media&amp;token=f14877b0-cfa4-47b1-ad86-cf16a175b879" alt=""><figcaption><p>[화면] 클러스터 할당/제거 창</p></figcaption></figure>

3\) 클러스터 할당/제거 창의 "선택하세요"에서 앞서 생성한 클러스터를 선택하고 "+ 추가" 버튼을 클릭합니다.

4\) 우측 하단의 "저장" 버튼을 클릭합니다.

5\) 할당 된 클러스터 목록에서 생성된 클러스터를 확인합니다.

### 3.2 클러스터 제거

1\) 클러스터 할당/제거 창에서 할당된 클러스터 우측의 "클러스터 할당/제거" 버튼을 클릭하면, 클러스터 할당/제거 창이 나타납니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FGVsb4QKSqukwpSzvSvOO%2Fimage.png?alt=media&amp;token=60fef110-5846-4420-9b8f-dabf155f3509" alt=""><figcaption><p>[화면] 클러스터 할당/제거 창</p></figcaption></figure>

2\) 삭제하려는 클러스터 우측의 "-"버튼을 눌러 목록에서 제거한 후 우측 하단의 "저장" 버튼을 클릭합니다.

3\) 할당된 클러스터 목록에서 클러스터가 제거된 것을 확인합니다.

## 4. 서비스 맵 할당/회수

### 4.1 서비스 맵 할당

1\) 워크스페이스 화면의 목록에서 생성된 워크스페이스명을 선택합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FrMzt89JbNYxZ6EmB7FHV%2Fimage.png?alt=media&amp;token=d126f3be-c8c8-4051-bb2a-50a2381f2c1c" alt=""><figcaption><p>[화면] 생성된 워크스페이스명 클릭 후 화면</p></figcaption></figure>

2\) 할당된 서비스 맵 우측의 "서비스 맵 할당/회수" 버튼을 클릭합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2Fgit-blob-40860e8ea9d932b4360626ec31b33b597f5949c1%2Fimage.png?alt=media" alt=""><figcaption><p>[화면] 서비스 맵 할당 / 회수</p></figcaption></figure>

3\) 클러스터를 선택하고 서비스 맵도 선택한 후 "+ 추가" 버튼을 클릭합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2Fgit-blob-9656b5a5bac0c36408ed331c316381624cd8bc4b%2Fimage.png?alt=media" alt=""><figcaption><p>[화면] 서비스 맵 할당 / 회수</p></figcaption></figure>

4\) 목록에 추가된 것을 확인하고 대상 서비스 맵 그룹을 선택하고 우측 하단의 "저장" 버튼을 클릭합니다.

5\) 할당된 서비스 맵 목록에서 서비스 맵이 할당된 것을 확인합니다.

### 4.2 서비스맵 회수

1\) 할당 된 서비스 맵 우측의 "서비스 맵 할당/회수" 버튼을 클릭합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2Fgit-blob-391305bc00e33eb3c47afcc145924bc5d1ef69fd%2Fimage.png?alt=media" alt=""><figcaption><p>[화면] 서비스 맵 할당 / 회수</p></figcaption></figure>

2\) 회수하려는 서비스 맵 우측의 "-"버튼을 눌러 목록에서 회수한 후 우측 하단의 "저장" 버튼을 클릭합니다.

3\) 할당된 서비스 맵 목록에서 서비스 맵이 회수된 것을 확인합니다.

## 5. 빌드 서버 할당/제거

### 5.1 빌드 서버 할당

1\) 워크스페이스 화면의 목록에서 생성된 워크스페이스 명을 선택합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FhRdOxsd3YtKPA9KvBdAe%2Fimage.png?alt=media&amp;token=eecc7f90-80d9-4ae5-9562-b3162d1739a1" alt=""><figcaption><p>[화면] 생성된 워크스페이스명 클릭 후 화면</p></figcaption></figure>

2\) 할당된 빌드 서버 우측의 "빌드 서버 할당/제거"를 선택합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FHAjqi4bzSa46zcIhMXdo%2Fimage.png?alt=media&amp;token=e4f48254-0af3-4369-a2b7-52b7b7d4cc40" alt=""><figcaption><p>[화면] 빌드 서버 할당/제거</p></figcaption></figure>

3\) 빌드 서버를 선택한 후 "+ 추가" 버튼을 클릭합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FC7oeZE9TAJZekuak0DhB%2Fimage.png?alt=media&amp;token=97b95e0e-3796-477e-bf02-2871ce90e67d" alt=""><figcaption><p>[화면] 빌드 서버 할당/제거</p></figcaption></figure>

4\) 목록에 추가된 것을 확인하고 우측 하단의 "저장" 버튼을 클릭합니다.

5\) 할당된 빌드 서버 목록에서 빌드 서버가 할당된 것을 확인합니다.

### 5.2 빌드 서버 제거

1\) 할당된 빌드 서버 우측의 "빌드 서버 할당/제거" 버튼을 클릭합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2F4sywyW8ZU0Wu43MOyMyI%2Fimage.png?alt=media&amp;token=cdd0de18-d181-4f17-a16a-f2b59358e915" alt=""><figcaption><p>[화면] 빌드 서버 할당/제거</p></figcaption></figure>

2\) 회수하려는 빌드 서버 우측의 "-"버튼을 눌러 목록에서 회수한 후 우측 하단의 "저장" 버튼을 클릭합니다.

3\) 할당된 빌드 서버 목록에서 빌드 서버가 회수된 것을 확인합니다.

## 6. 구성원 등록/제거

### 6.1 구성원 등록

* 사용자 권한으로 등록된 사용자는 워크스페이스로 접근하기 위해 구성원을 등록해야합니다.

1\) 구성원 우측의 "구성원 등록/제거" 버튼을 클릭합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FKqy9DHutQXdd99imeDqa%2Fimage.png?alt=media&amp;token=9474b302-81ad-40ef-94b9-a885248a355e" alt=""><figcaption><p>[화면] 생성된 워크스페이스명 클릭 후 화면</p></figcaption></figure>

2\) 워크스페이스에 등록할 구성원의 이름을 선택하고 권한을 부여 후 하단의 "저장" 버튼을 클릭합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2Fgit-blob-16a6844fc2e29ee9e2cf9ed64eff420002551912%2Fimage.png?alt=media" alt=""><figcaption><p>[화면] 구성원 등록/제거</p></figcaption></figure>

<table><thead><tr><th width="130">권한</th><th>기능</th></tr></thead><tbody><tr><td>MANAGER</td><td>워크스페이스/클러스터/서비스맵의 생성 및 삭제 외 모든 기능 가능</td></tr><tr><td>USER</td><td>워크스페이스 설정, 자원할당, Limit Rages, 네트워크 정책 기능을 제외한 모든 기능</td></tr><tr><td>DEVOPS</td><td>CI/CD Pipeline 기능 중 이미지 빌드만 실행 가능(배포 및 삭제 불가)</td></tr><tr><td>DEV</td><td>CI/CD Pipeline 조회만 가능(배포, 수정 및 삭제 불가)</td></tr><tr><td>VIEWER</td><td>USER 권한에서 조회만 가능</td></tr></tbody></table>

3\) 구성원이 선택한 권한으로 등록되었는지 확인합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2Fqaegx6qhhUIpPIAQ3ybZ%2Fimage.png?alt=media&amp;token=17f4d2d1-47a4-4ec0-9b81-b663b1c8213d" alt=""><figcaption><p>[화면] 워크스페이스에 구성원등록 완료 화면</p></figcaption></figure>

### 6.2 구성원 제거

1\) 구성원 우측의 "구성원 등록/제거" 버튼을 클릭합니다.

2\) 제거할 구성원의 이름을 선택하여 콤보박스를 해제 후 "저장" 버튼을 클릭합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2Fgit-blob-7b6661dc16f84fa97e8de5bc84e16d9f49bfd447%2Fimage.png?alt=media" alt=""><figcaption><p>[화면] 구성원 등록/제거</p></figcaption></figure>

3\) 해당 구성원이 제거가 되었는지 확인합니다.

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FLdgGQ3wILkCpqfQN8VCJ%2Fimage.png?alt=media&amp;token=c8468060-63a9-46e6-896a-bc153d7f8970" alt=""><figcaption><p>[화면] 워크스페이스에 구성원 제거 완료 화면</p></figcaption></figure>