관리 가이드

프로세스

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

   $ dsc server:delete

   Copy to Clipboard

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

   $ dsc server:deploy --platform openshift

   Copy to Clipboard

검증 단계

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

   $ dsc server:status

   Copy to Clipboard

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

   $ dsc dashboard:open

   Copy to Clipboard

프로세스

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

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

   작은 정보

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

   경고

   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
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

   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
3. OpenShift Dev Spaces 네임스페이스에서 사용자 프로젝트의 모든 Pod로 들어오는 트래픽을 허용합니다. 4.8.1절. “네트워크 정책 구성” 을 참조하십시오.

검증

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

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

   Copy to Clipboard

프로세스

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

   $ oc edit checluster/devspaces -n openshift-devspaces

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

검증

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

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

   Copy to Clipboard

프로세스

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

   devEnvironments:
     defaultNamespace:
       autoProvision: false

   Copy to Clipboard

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

   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

   예 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

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

   예 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

   참고

   작업 영역 시작 시 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

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

   예 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

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

     매개변수는 선택 사항이며 사용할 수 있는 매개변수를 정의합니다. 현재 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

     참고

     템플릿 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

   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

2. maxNumberOfWorkspacesPerUser 를 구성합니다.

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

   1

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

   2

   Copy to Clipboard

   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

   1

   < running_workspaces_limit> 값을 선택합니다.

프로세스

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

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

   Copy to Clipboard

2. maxNumberOfRunningWorkspacesPerUser 를 구성합니다.

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

   1

   
   --type='merge' -p \
   '{"spec":{"devEnvironments":{"maxNumberOfRunningWorkspacesPerUser": <running_workspaces_limit>}}}'

   2

   Copy to Clipboard

   1

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

   2

   < running_workspaces_limit> 값을 선택합니다.

프로세스

1. Git 서버에 대한 세부 정보를 사용하여 새 ConfigMap 을 생성합니다.

   $ oc create configmap che-git-self-signed-cert \
     --from-file=ca.crt=<path_to_certificate> \  

   1

   
     --from-literal=githost=<git_server_url> -n openshift-devspaces  

   2

   Copy to Clipboard

   1

   자체 서명된 인증서의 경로입니다.

   2

   Git 서버 URL을 지정하는 선택적 매개변수(예: https://git.example.com:8443 ). 생략하면 자체 서명된 인증서는 HTTPS를 통해 모든 리포지토리에 사용됩니다.

   참고
   • 인증서 파일은 일반적으로 다음과 같은 Base64 ASCII 파일로 저장됩니다. .pem, .crt, .ca-bundle. 인증서 파일이 있는 모든 ConfigMap 은 바이너리 데이터 인증서 대신 Base64 ASCII 인증서를 사용해야 합니다.
   • 신뢰의 인증서 체인이 필요합니다. ca.crt 가 CA(인증 기관)에서 서명한 경우 ca.crt 파일에 CA 인증서를 포함해야 합니다.

2. ConfigMap에 필요한 라벨을 추가합니다.

   $ oc label configmap che-git-self-signed-cert \
     app.kubernetes.io/part-of=che.eclipse.org -n openshift-devspaces

   Copy to Clipboard

3. Git 리포지토리에 자체 서명된 인증서를 사용하도록 OpenShift Dev Spaces 피연산자를 구성합니다. 4.1.2절. “CLI를 사용하여 CheCluster 사용자 정의 리소스 구성”을 참조하십시오.

   spec:
     devEnvironments:
       trustedCerts:
         gitTrustedCertsConfigMapName: che-git-self-signed-cert

   Copy to Clipboard

프로세스

1. NodeSelector 사용

   OpenShift Dev Spaces는 CheCluster 사용자 정의 리소스를 사용하여 nodeSelector 를 구성합니다.

   spec:
     devEnvironments:
       nodeSelector:
         key: value

   Copy to Clipboard

   이 섹션에는 nodeSelector 규칙을 형성하려면 각 노드 라벨 에 대한 키=값 쌍 세트가 포함되어야 합니다.

2. Taints 및 Tolerations 사용

   이 방법은 nodeSelector 와 반대의 방식으로 작동합니다. Pod가 예약될 노드를 지정하는 대신 Pod를 예약할 수 없는 노드를 지정합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/scheduling-eviction/taint-and-toleration 을 참조하십시오.

   OpenShift Dev Spaces는 CheCluster 사용자 정의 리소스를 사용하여 허용 오차 를 구성합니다.

   spec:
     devEnvironments:
       tolerations:
         - effect: NoSchedule
           key: key
           value: value
           operator: Equal

   Copy to Clipboard

1. 허용되는 소스를 구성합니다.

   oc patch checluster/devspaces \
       --namespace openshift-devspaces \
       --type='merge' \
       -p \
   '{
      "spec": {
        "devEnvironments": {
          "allowedSources": {
            "urls": ["url_1", "url_2"] 

   1

   
          }
        }
      }
    }'

   Copy to Clipboard

   1

   클라우드 개발 환경(CDE)을 시작하기 위해 승인된 URL의 배열입니다. CDE는 이러한 URL에서만 시작할 수 있습니다. 와일드카드 * 는 URL에서 지원됩니다. 예를 들어 https://example.com/* 에서는 example.com 내의 모든 경로에서 CDE를 시작할 수 있습니다.

프로세스

1. OpenShift Dev Spaces Operator가 배포된 네임스페이스를 찾습니다.

   OPERATOR_NAMESPACE=$(oc get pods -l app.kubernetes.io/component=devspaces-operator -o jsonpath={".items[0].metadata.namespace"} --all-namespaces)

   Copy to Clipboard

2. Image Puller에서 사전 가져올 수 있는 이미지를 확인합니다.

   oc exec -n $OPERATOR_NAMESPACE deploy/devspaces-operator -- cat /tmp/external_images.txt

   Copy to Clipboard