관리 가이드

프로세스

1. 선택 사항: 이전에 이 OpenShift 클러스터에 OpenShift Dev Spaces를 배포한 경우 이전 OpenShift Dev Spaces 인스턴스가 제거되었는지 확인합니다.

   $ dsc server:delete

   Copy to Clipboard Toggle word wrap

2. OpenShift Dev Spaces 인스턴스를 생성합니다.

   $ dsc server:deploy --platform openshift

   Copy to Clipboard Toggle word wrap

검증 단계

1. OpenShift Dev Spaces 인스턴스 상태를 확인합니다.

   $ dsc server:status

   Copy to Clipboard Toggle word wrap

2. OpenShift Dev Spaces 클러스터 인스턴스로 이동합니다.

   $ dsc dashboard:open

   Copy to Clipboard Toggle word wrap

프로세스

1. OpenShift 웹 콘솔의 관리자 보기에서 Operator → OperatorHub 로 이동하여 Red Hat OpenShift Dev Spaces 를 검색합니다.

2. Red Hat OpenShift Dev Spaces Operator를 설치합니다.

   작은 정보

   웹 콘솔을 사용하여 OperatorHub에서 설치를 참조하십시오.

   Important

   Red Hat OpenShift Dev Spaces Operator는 Dev Workspace Operator에 따라 다릅니다. Red Hat OpenShift Dev Spaces Operator를 기본이 아닌 네임스페이스에 수동으로 설치하는 경우 Dev Workspace Operator도 동일한 네임스페이스에 설치되어 있는지 확인합니다. 이는 Operator Lifecycle Manager에서 Red Hat OpenShift Dev Spaces Operator 네임스페이스의 종속성으로 Dev Workspace Operator를 설치하려고 시도하므로 후자가 다른 네임스페이스에 설치된 경우 Dev Workspace Operator의 두 가지 충돌이 발생할 수 있습니다.

1. 다음과 같이 OpenShift에서 openshift-devspaces 프로젝트를 생성합니다.

   oc create namespace openshift-devspaces

   Copy to Clipboard Toggle word wrap
2. Operator → 설치된 Operator → Red Hat OpenShift Dev Spaces 인스턴스 사양 → CheCluster → YAML 보기로 이동합니다.
3. YAML 보기에서 namespace: openshift-operators 를 namespace: openshift-devspaces 로 바꿉니다.

4. 생성을 선택합니다.

   작은 정보

   설치된 Operator에서 애플리케이션 생성 을 참조하십시오.

1. Red Hat OpenShift Dev Spaces 인스턴스 사양에서 devspaces 로 이동하여 세부 정보 탭을 시작합니다.

1. Message 에서 None 이 있는지 확인합니다. 즉, 오류가 없음을 의미합니다.
2. Red Hat OpenShift Dev Spaces URL 에서 OpenShift Dev Spaces 인스턴스의 URL이 표시될 때까지 기다린 다음 URL을 열어 OpenShift Dev Spaces 대시보드를 확인합니다.
3. 리소스 탭에서 OpenShift Dev Spaces 배포의 리소스와 해당 상태를 확인합니다.

프로세스

1. 미러링 스크립트를 다운로드하여 실행하여 사용자 정의 Operator 카탈로그를 설치하고 관련 이미지( prepare-restricted-environment.sh )를 미러링합니다.

   $ bash prepare-restricted-environment.sh \
     --devworkspace_operator_index registry.redhat.io/redhat/redhat-operator-index:v4.17\
     --devworkspace_operator_version "v0.32.0" \
     --prod_operator_index "registry.redhat.io/redhat/redhat-operator-index:v4.17" \
     --prod_operator_package_name "devspaces" \
     --prod_operator_bundle_name "devspacesoperator" \
     --prod_operator_version "v3.18.0" \
     --my_registry "<my_registry>" 

   1

   Copy to Clipboard Toggle word wrap

   1

   이미지를 미러링할 프라이빗 Docker 레지스트리

2. 이전 단계에서 che-operator-cr-patch.yaml 에 설정된 구성으로 OpenShift Dev Spaces를 설치합니다.

   $ dsc server:deploy \
     --platform=openshift \
     --olm-channel stable \
     --catalog-source-name=devspaces-disconnected-install \
     --catalog-source-namespace=openshift-marketplace \
     --skip-devworkspace-operator \
     --che-operator-cr-patch-yaml=che-operator-cr-patch.yaml

   Copy to Clipboard Toggle word wrap
3. OpenShift Dev Spaces 네임스페이스에서 사용자 프로젝트의 모든 Pod로 들어오는 트래픽을 허용합니다. 4.8.1절. “네트워크 정책 구성” 을 참조하십시오.

검증

1. 구성된 속성의 값을 확인합니다.

   $ oc get configmap che -o jsonpath='{.data.<configured_property>}' \
   -n openshift-devspaces

   Copy to Clipboard Toggle word wrap

프로세스

1. 클러스터에서 CheCluster 사용자 정의 리소스를 편집합니다.

   $ oc edit checluster/devspaces -n openshift-devspaces

   Copy to Clipboard Toggle word wrap
2. 파일을 저장하고 종료하여 변경 사항을 적용합니다.

검증

1. 구성된 속성의 값을 확인합니다.

   $ oc get configmap che -o jsonpath='{.data.<configured_property>}' \
   -n openshift-devspaces

   Copy to Clipboard Toggle word wrap

프로세스

1. CheCluster 수준에서 자동 네임스페이스 프로비저닝을 비활성화합니다.

   devEnvironments:
     defaultNamespace:
       autoProvision: false

   Copy to Clipboard Toggle word wrap

2. 다음 라벨 및 주석을 사용하여 < username > 사용자에 대한 <project_name > 프로젝트를 생성합니다.

   kind: Namespace
   apiVersion: v1
   metadata:
     name: <project_name> 

   1

   
     labels:
       app.kubernetes.io/part-of: che.eclipse.org
       app.kubernetes.io/component: workspaces-namespace
     annotations:
       che.eclipse.org/username: <username>

   Copy to Clipboard Toggle word wrap

   1

   선택한 프로젝트 이름을 사용합니다.

프로세스

1. 아래 ConfigMap 을 생성하여 모든 사용자 네임스페이스에 복제합니다. 구성 가능성을 개선하기 위해 추가 라벨 및 주석을 추가하여 ConfigMap 을 사용자 지정할 수 있습니다. 기타 가능한 라벨 및 주석은 자동 마운트 볼륨, configmaps 및 시크릿 을 참조하십시오.

   kind: ConfigMap
   apiVersion: v1
   metadata:
     name: devspaces-user-configmap
     namespace: openshift-devspaces
     labels:
       app.kubernetes.io/part-of: che.eclipse.org
       app.kubernetes.io/component: workspaces-config
   data:
     ...

   Copy to Clipboard Toggle word wrap

   예 4.4. settings.xml 파일을 사용자 작업 공간에 마운트합니다.

   kind: ConfigMap
   apiVersion: v1
   metadata:
     name: devspaces-user-configmap
     namespace: openshift-devspaces
     labels:
       app.kubernetes.io/part-of: che.eclipse.org
       app.kubernetes.io/component: workspaces-config
     annotations:
       controller.devfile.io/mount-as: subpath
       controller.devfile.io/mount-path: /home/user/.m2
   data:
     settings.xml: |
       <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 https://maven.apache.org/xsd/settings-1.0.0.xsd">
         <localRepository>/home/user/.m2/repository</localRepository>
         <interactiveMode>true</interactiveMode>
         <offline>false</offline>
       </settings>

   Copy to Clipboard Toggle word wrap

2. 아래 Secret 을 생성하여 모든 사용자 네임스페이스에 복제합니다. 구성 가능성을 개선하기 위해 추가 라벨 및 주석을 추가하여 보안 을 사용자 지정할 수 있습니다. 기타 가능한 라벨 및 주석은 자동 마운트 볼륨, configmaps 및 시크릿 을 참조하십시오.

   kind: Secret
   apiVersion: v1
   metadata:
     name: devspaces-user-secret
     namespace: openshift-devspaces
     labels:
       app.kubernetes.io/part-of: che.eclipse.org
       app.kubernetes.io/component: workspaces-config
   data:
     ...

   Copy to Clipboard Toggle word wrap

   예 4.5. 사용자 작업 공간에 인증서 마운트:

   kind: Secret
   apiVersion: v1
   metadata:
     name: devspaces-user-secret
     namespace: openshift-devspaces
     labels:
       app.kubernetes.io/part-of: che.eclipse.org
       app.kubernetes.io/component: workspaces-config
     annotations:
       controller.devfile.io/mount-as: subpath
       controller.devfile.io/mount-path: /etc/pki/ca-trust/source/anchors
   stringData:
     trusted-certificates.crt: |
       ...

   Copy to Clipboard Toggle word wrap

   참고

   작업 영역 시작 시 update-ca-trust 명령을 실행하여 인증서를 가져옵니다. 수동으로 또는 devfile의 postStart 이벤트에 이 명령을 추가하여 수행할 수 있습니다. devfile의 이벤트 바인딩 추가를 참조하십시오.

   예 4.6. 사용자 작업 공간에 환경 변수 마운트:

   kind: Secret
   apiVersion: v1
   metadata:
     name: devspaces-user-secret
     namespace: openshift-devspaces
     labels:
       app.kubernetes.io/part-of: che.eclipse.org
       app.kubernetes.io/component: workspaces-config
     annotations:
       controller.devfile.io/mount-as: env
   stringData:
     ENV_VAR_1: value_1
     ENV_VAR_2: value_2

   Copy to Clipboard Toggle word wrap

3. 아래의 PersistentVolumeClaim 을 생성하여 모든 사용자 네임스페이스에 복제합니다.

   구성 가능성을 개선하기 위해 추가 라벨 및 주석을 추가하여 PersistentVolumeClaim 을 사용자 지정할 수 있습니다. 기타 가능한 라벨 및 주석은 자동 마운트 볼륨, configmaps 및 시크릿 을 참조하십시오.

   PersistentVolumeClaim 을 수정하려면 openshift-devspaces 네임스페이스에 새VolumeClaim을 삭제하고 생성합니다.

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: devspaces-user-pvc
     namespace: openshift-devspaces
     labels:
       app.kubernetes.io/part-of: che.eclipse.org
       app.kubernetes.io/component: workspaces-config
   spec:
     ...

   Copy to Clipboard Toggle word wrap

   예 4.7. 사용자 작업 공간에 PersistentVolumeClaim 마운트:

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: devspaces-user-pvc
     namespace: openshift-devspaces
     labels:
       app.kubernetes.io/part-of: che.eclipse.org
       app.kubernetes.io/component: workspaces-config
       controller.devfile.io/mount-to-devworkspace: 'true'
     annotations:
       controller.devfile.io/mount-path: /home/user/data
       controller.devfile.io/read-only: 'true'
   spec:
     accessModes:
       - ReadWriteOnce
     resources:
       requests:
         storage: 5Gi
     volumeMode: Filesystem

   Copy to Clipboard Toggle word wrap

4. OpenShift Kubernetes Engine을 활용하려면 템플릿 오브젝트를 생성하여 각 사용자 네임스페이스에서 템플릿에 정의된 모든 리소스를 복제할 수 있습니다.

   이전에 언급한 ConfigMap,Secret, PersistentVolumeClaim 외에도Template 오브젝트에는 다음이 포함될 수 있습니다.

   • LimitRange
   • NetworkPolicy
   • resourceQuota
   • Role

   • RoleBinding

     apiVersion: template.openshift.io/v1
     kind: Template
     metadata:
       name: devspaces-user-namespace-configurator
       namespace: openshift-devspaces
       labels:
         app.kubernetes.io/part-of: che.eclipse.org
         app.kubernetes.io/component: workspaces-config
     objects:
       ...
     parameters:
     - name: PROJECT_NAME
     - name: PROJECT_ADMIN_USER

     Copy to Clipboard Toggle word wrap

     매개변수는 선택 사항이며 사용할 수 있는 매개변수를 정의합니다. 현재 PROJECT_NAME 및 PROJECT_ADMIN_USER 만 지원됩니다. PROJECT_NAME 은 OpenShift Dev Spaces 네임스페이스의 이름이며 PROJECT_ADMIN_USER 는 네임스페이스의 OpenShift Dev Spaces 사용자입니다.

     오브젝트의 네임스페이스 이름은 동기화 중에 사용자의 네임스페이스 이름으로 교체됩니다.

     예 4.8. Kubernetes 리소스를 사용자 네임스페이스에 복제합니다.

     apiVersion: template.openshift.io/v1
     kind: Template
     metadata:
       name: devspaces-user-namespace-configurator
       namespace: openshift-devspaces
       labels:
         app.kubernetes.io/part-of: che.eclipse.org
         app.kubernetes.io/component: workspaces-config
     objects:
     - apiVersion: v1
       kind: ResourceQuota
       metadata:
         name: devspaces-user-resource-quota
       spec:
         ...
     - apiVersion: v1
       kind: LimitRange
       metadata:
         name: devspaces-user-resource-constraint
       spec:
         ...
     - apiVersion: rbac.authorization.k8s.io/v1
       kind: Role
       metadata:
         name: devspaces-user-roles
       rules:
         ...
     - apiVersion: rbac.authorization.k8s.io/v1
       kind: RoleBinding
       metadata:
         name: devspaces-user-rolebinding
       roleRef:
         apiGroup: rbac.authorization.k8s.io
         kind: Role
         name: devspaces-user-roles
       subjects:
       - kind: User
         apiGroup: rbac.authorization.k8s.io
         name: ${PROJECT_ADMIN_USER}
     parameters:
     - name: PROJECT_ADMIN_USER

     Copy to Clipboard Toggle word wrap

     참고

     템플릿 Kubernetes 리소스 생성은 OpenShift에서만 지원됩니다.

프로세스

1. 대상 지표와 원하는 복제본 수를 지정하여 배포에 대한 HPA 리소스를 생성합니다.

   apiVersion: autoscaling/v2
   kind: HorizontalPodAutoscaler
   metadata:
     name: scaler
     namespace: openshift-devspaces
   spec:
     scaleTargetRef:
       apiVersion: apps/v1
       kind: Deployment
       name: <deployment_name> 

   1

   
     ...

   Copy to Clipboard Toggle word wrap

   1

   & lt;deployment_name >은 다음 배포에 해당합니다.

   • devspaces
   • che-gateway
   • devspaces-dashboard
   • plugin-registry
   • devfile-registry

프로세스

1. OpenShift Dev Spaces 네임스페이스의 이름을 가져옵니다. 기본값은 openshift-devspaces 입니다.

   $ oc get checluster --all-namespaces \
     -o=jsonpath="{.items[*].metadata.namespace}"

   Copy to Clipboard Toggle word wrap

2. maxNumberOfWorkspacesPerUser 를 구성합니다.

   $ oc patch checluster/devspaces -n openshift-devspaces \

   1

   
   --type='merge' -p \
   '{"spec":{"devEnvironments":{"maxNumberOfWorkspacesPerUser": <kept_workspaces_limit>}}}'

   2

   Copy to Clipboard Toggle word wrap

   1

   1단계에서 가져온 OpenShift Dev Spaces 네임스페이스입니다.

   2

   < kept_workspaces_limit> 값을 선택합니다.

프로세스

1. maxNumberOfRunningWorkspacesPerCluster 를 구성합니다.

   oc patch checluster/devspaces -n openshift-devspaces \
   --type='merge' -p \
   '{"spec":{"devEnvironments":{"maxNumberOfRunningWorkspacesPerCluster": <running_workspaces_limit>}}}'

   1

   Copy to Clipboard Toggle word wrap

   1

   < running_workspaces_limit> 값을 선택합니다.