1장. Dev Spaces 시작하기


조직에서 이미 OpenShift Dev Spaces 인스턴스를 실행 중인 경우 새 작업 공간을 시작하고, 작업 영역을 관리하고, 작업 영역에서 Git 서버로 인증하는 방법을 학습하여 새 사용자로 시작할 수 있습니다.

1.1. Git 리포지토리 URL에서 작업 공간 시작

이 절차의 컨텍스트에서 "Git 리포지토리 URL"은 리포지토리의 git clone URL을 나타냅니다. 일반적으로 SCM 리포지토리의 기본 페이지에서 Clone 버튼을 클릭하여 이 URL을 가져올 수 있습니다. 또는 리포지토리의 기본 페이지에 있을 때 브라우저의 주소 표시줄에서 URL을 복사할 수 있습니다. 분기 또는 태그를 선택하면 URL에 참조 매개변수가 추가됩니다.

참고

GitHub의 경우 devfile과 함께 디렉터리의 리포지토리 URL 또는 devfile의 리포지토리 URL을 사용할 수도 있습니다. devfile의 이름은 devfile.yaml 또는 .devfile.yaml 이어야 합니다.

이 기능은 다른 Git 공급자에서는 지원되지 않습니다.

OpenShift Dev Spaces를 사용하면 브라우저에서 URL을 사용하여 Git 리포지토리 복제본이 포함된 새 작업 공간을 시작할 수 있습니다. 이렇게 하면 GitHub, GitLab, Bitbucket 또는 Microsoft Azure DevOps 서버 인스턴스에서 호스팅되는 Git 리포지토리를 복제할 수 있습니다.

작은 정보

OpenShift Dev Spaces 대시보드의 Create Workspace 페이지에서 Git Repository URL 필드를 사용하여 Git 리포지토리의 URL을 입력하여 새 작업 영역을 시작할 수도 있습니다.

중요
  • SSH URL을 사용하여 새 작업 공간을 시작하는 경우 SSH 키를 전파해야 합니다. 자세한 내용은 Git 작업에 SSH 키를 사용하도록 DevWorkspaces 구성 을 참조하십시오.
  • SSH URL이 개인 리포지토리를 가리키는 경우 devfile.yaml 콘텐츠를 가져올 수 있도록 액세스 토큰을 적용해야 합니다. SCM 인증 페이지를 수락하거나 개인 액세스 토큰 절차에 따라 이 작업을 수행할 수 있습니다.
중요

개인 리포지토리에 액세스하도록 개인 액세스 토큰을 구성합니다. 6.1.2절. “Git-provider 액세스 토큰 사용”을 참조하십시오.

사전 요구 사항

  • 조직에는 실행 중인 OpenShift Dev Spaces 인스턴스가 있습니다.
  • 조직의 OpenShift Dev Spaces 인스턴스의 FQDN URL을 알고 있습니다. https:// <openshift_dev_spaces_fqdn>.
  • 선택 사항: Git 서버 구성에 대한 인증이 있어야 합니다.
  • Git 리포지토리 유지 관리자는 devfile.yaml 또는 .devfile.yaml 파일을 Git 리포지토리의 루트 디렉터리에 유지합니다. (다른 파일 이름 및 파일 경로는 1.1.1절. “새 작업 공간을 시작하기 위한 URL의 선택적 매개변수” 을 참조하십시오.)

    작은 정보

    devfile이 없는 Git 리포지토리의 URL을 제공하여 새 작업 공간을 시작할 수도 있습니다. 이렇게 하면 Universal Developer Image 및 Microsoft Visual Studio Code가 있는 작업 공간 - 작업 공간 IDE로 오픈 소스가 생성됩니다.

프로세스

Git 리포지토리 복제본으로 새 작업 공간을 시작하려면 다음을 수행합니다.

  1. 선택 사항: OpenShift Dev Spaces 대시보드 페이지를 방문하여 조직의 OpenShift Dev Spaces 인스턴스에 인증합니다.
  2. URL을 방문하여 기본 구문을 사용하여 새 작업 공간을 시작합니다.

    https://<openshift_dev_spaces_fqdn>#<git_repository_url>
    작은 정보

    선택적 매개변수를 사용하여 이 URL을 확장할 수 있습니다.

    https://<openshift_dev_spaces_fqdn>#<git_repository_url>?<optional_parameters> 
    1
    작은 정보

    Git+SSH URL을 사용하여 새 작업 공간을 시작할 수 있습니다. Git 작업에 SSH 키를 사용하도록 DevWorkspaces 구성을참조하십시오.

    예 1.1. 새 작업 공간을 시작하기 위한 URL

    • https://<openshift_dev_spaces_fqdn>#https://github.com/che-samples/cpp-hello-world
    • https://<openshift_dev_spaces_fqdn>#git@github.com:che-samples/cpp-hello-world.git

    예 1.2. GitHub 인스턴스 리포지토리 복제본으로 새 작업 공간을 시작하기 위한 URL 구문

    • https:// <openshift_dev_spaces_fqdn> #https:/// <user_or_org> / <repository >는 기본 분기의 복제본으로 새 작업 공간을 시작합니다.
    • https:// <openshift_dev_spaces_fqdn> #https:/// <user_or_org> / <repository> /tree/ <branch_name >은 지정된 분기의 복제로 새 작업 영역을 시작합니다.
    • https:// <openshift_dev_spaces_fqdn> #https:/// <user_or_org> / <repository> /pull/ <pull_request_id >는 가져오기 요청 분기의 분기 복제를 사용하여 새 작업 영역을 시작합니다.
    • https:// <openshift_dev_spaces_fqdn> #git@: <user_or_org> / <repository > .git 은 Git+SSH URL에서 새 작업 영역을 시작합니다.

    예 1.3. GitLab 인스턴스 리포지토리 복제본으로 새 작업 공간을 시작하기 위한 URL 구문

    • https:// <openshift_dev_spaces_fqdn> #https:/// <user_or_org> / <repository >는 기본 분기의 복제본으로 새 작업 공간을 시작합니다.
    • https:// <openshift_dev_spaces_fqdn> #https:/// <user_or_org> / <repository> /-/tree/ <branch_name >은 지정된 분기의 복제본으로 새 작업 영역을 시작합니다.
    • https:// <openshift_dev_spaces_fqdn> #git@: <user_or_org> / <repository > .git 은 Git+SSH URL에서 새 작업 영역을 시작합니다.

    예 1.4. BitBucket Server 리포지토리 복제본으로 새 작업 공간을 시작하기 위한 URL 구문

    • https:// <openshift_dev_spaces_fqdn> #https:// <bb_host> /scm/ <project-key> / <repository > .git 은 기본 분기를 복제하여 새 작업 영역을 시작합니다.
    • HTTPS :// <openshift_dev_spaces_fqdn> #https:// <bb_host> /users/ <user_slug> /repos/ <repository > /repository는 사용자 프로필 아래에 리포지토리가 생성된 경우 기본 분기의 복제본으로 새 작업 영역을 시작합니다.
    • https:// <openshift_dev_spaces_fqdn> #https:// <bb_host> /users/ <user-slug> /repos/ <repository> /browse?at=refs%2Fheads%2F <branch-name >은 지정된 분기의 복제본으로 새 작업 공간을 시작합니다.
    • https:// <openshift_dev_spaces_fqdn> #git@ <bb_host > : <user_slug> / <repository > .git 은 Git+SSH URL에서 새 작업 영역을 시작합니다.

    예 1.5. Microsoft Azure DevOps Git 리포지토리 복제본으로 새 작업 공간을 시작하기 위한 URL 구문

    • https:// <openshift_dev_spaces_fqdn> #https:// <organization> @dev.azure.com/ <organization> / <project> /_git/ <repository >는 기본 분기의 복제본이 포함된 새 작업 영역을 시작합니다.
    • https:// <openshift_dev_spaces_fqdn> #https:// <organization> @dev.azure.com/ <organization> / <project> /_git/ <repository > ?version=GB <branch >는 특정 분기 복제를 사용하여 새 작업 영역을 시작합니다.
    • HTTPS :// <openshift_dev_spaces_fqdn> #git@ssh.dev.azure.com:v3/ <organization> / <project> / <repository >는 Git+SSH URL에서 새 작업 공간을 시작합니다.

    URL을 입력하여 브라우저 탭에서 새 작업 공간을 시작하면 작업 영역 시작 페이지가 표시됩니다.

    새 작업 공간이 준비되면 작업 공간 IDE가 브라우저 탭에 로드됩니다.

    Git 리포지토리의 복제본이 새 작업 공간의 파일 시스템에 있습니다.

    작업 공간의 고유 URL은 https:// <openshift_dev_spaces_fqdn> / <user_name> / <unique_url >입니다.

1.1.1. 새 작업 공간을 시작하기 위한 URL의 선택적 매개변수

새 작업 공간을 시작할 때 OpenShift Dev Spaces는 devfile의 지침에 따라 작업 공간을 구성합니다. URL을 사용하여 새 작업 영역을 시작할 때 작업 영역을 추가로 구성하는 URL에 선택적 매개변수를 추가할 수 있습니다. 이러한 매개변수를 사용하여 작업 공간 IDE를 지정하고, 중복된 작업 공간을 시작하고, devfile 파일 이름 또는 경로를 지정할 수 있습니다.

1.1.1.1. URL 매개변수 연결

새 작업 공간을 시작하기 위한 URL은 다음 URL 구문과 함께 & amp;를 사용하여 여러 선택적 URL 매개변수를 연결할 수 있도록 지원합니다.

HTTPS:// <openshift_dev_spaces_fqdn> #? <url_parameter_1> & <url_parameter_2> & <url_parameter_3>

예 1.6. Git 리포지토리의 URL 및 선택적 URL 매개변수를 사용하여 새 작업 공간을 시작하는 URL

브라우저의 전체 URL:

https:// &lt;openshift_dev_spaces_fqdn&gt; #https://github.com/che-samples/cpp-hello-world?new&che-editor=che-incubator/intellij-community/latest&devfilePath=tests/testdevfile.yaml

URL 부분에 대한 설명:

https://<openshift_dev_spaces_fqdn> 
1

#https://github.com/che-samples/cpp-hello-world 
2

?new&che-editor=che-incubator/intellij-community/latest&devfilePath=tests/testdevfile.yaml 
3
1
OpenShift Dev Spaces URL.
2
새 작업 공간에 복제할 Git 리포지토리의 URL입니다.
3
연결된 선택적 URL 매개변수입니다.

1.1.1.2. IDE의 URL 매개변수

che-editor= URL 매개변수를 사용하여 작업 영역을 시작할 때 지원되는 IDE를 지정할 수 있습니다.

작은 정보

소스 코드 Git 리포지토리에서 /.che/che-editor.yaml 파일을 추가하거나 편집할 수 없는 경우 che-editor= 매개변수를 사용하여 작업 공간에 복제하십시오.

참고

che-editor= 매개변수는 /.che/che-editor.yaml 파일을 재정의합니다.

이 매개변수는 다음 두 가지 유형의 값을 허용합니다.

  • che-editor=<editor_key>

    https://<openshift_dev_spaces_fqdn>#<git_repository_url>?che-editor=<editor_key>
    Expand
    표 1.1. 지원되는 IDE에 대한 URL 매개변수 <editor_key > 값
    IDE상태editor_key참고

    Microsoft Visual Studio Code - 오픈 소스

    Available

    • che-incubator/che-code/latest
    • che-incubator/che-code/insiders
    • latest 는 URL 매개변수 또는 che-editor.yaml 을 사용하지 않을 때 새 작업 공간에 로드되는 기본 IDE입니다.
    • 내부자 는 개발 버전입니다.

    CryostatBrains IntelliJ IDEA Community Edition

    더 이상 사용되지 않음

    • che-incubator/che-idea/latest
    • che-incubator/che-idea/next
    • latest 는 안정적인 버전입니다.
    • 다음은 development 버전입니다.

    CryostatBrains IntelliJ IDEA Cryostat 버전 ( CryostatBrains Gateway 이상)

    기술 프리뷰

    • che-incubator/che-idea-server/latest
    • che-incubator/che-idea-server/next
    • latest 는 안정적인 버전입니다.
    • 다음은 development 버전입니다.
  • che-editor=<url_to_a_file>

    https://<openshift_dev_spaces_fqdn>#<git_repository_url>?che-editor=<url_to_a_file>
    1
    1
    devfile 콘텐츠 가 있는 파일의 URL입니다.
    작은 정보
    • URL은 원시 파일 콘텐츠를 가리켜야 합니다.
    • 이 매개변수를 che-editor.yaml 파일과 함께 사용하려면 다른 이름 또는 경로가 있는 파일을 복사한 다음 파일에서 인라인 으로 행을 제거합니다.

1.1.1.3. IDE 이미지의 URL 매개변수

editor-image 매개변수를 사용하여 작업 공간에 대한 사용자 지정 IDE 이미지를 설정할 수 있습니다.

중요
  • Git 리포지토리에 /.che/che-editor.yaml 파일이 포함된 경우 사용자 지정 편집기가 새 IDE 이미지로 재정의됩니다.
  • Git 리포지토리에 /.che/che-editor.yaml 파일이 없으면 기본 편집기가 새 IDE 이미지로 재정의됩니다.
  • 지원되는 IDE를 재정의하고 대상 편집기 이미지를 변경하려면 che-editoreditor-image URL 매개변수를 모두 함께 사용할 수 있습니다.

IDE 이미지를 재정의하는 URL 매개변수는 editor-image=:입니다.

https://<openshift_dev_spaces_fqdn>#<git_repository_url>?editor-image=<container_registry/image_name:image_tag>

예제:

https:// &lt;openshift_dev_spaces_fqdn&gt; #https://github.com/eclipse-che/che-docs?editor-image=quay.io/che-incubator/che-code:next

또는

https:// &lt;openshift_dev_spaces_fqdn&gt; #https://github.com/eclipse-che/che-docs?che-editor=che-incubator/che-code/latest&editor-image=quay.io/che-incubator/che-code:next

1.1.1.4. 중복 작업 공간을 시작하기 위한 URL 매개변수

새 작업 공간을 시작하기 위한 URL을 방문하면 devfile 및 연결된 Git 리포지토리 복제본에 따라 새 작업 공간이 생성됩니다.

devfile 및 연결된 Git 리포지토리와 관련하여 중복된 작업 공간이 여러 개 있어야 하는 경우도 있습니다. URL 매개변수로 새 작업 영역을 시작하기 위해 동일한 URL을 방문하여 이 작업을 수행할 수 있습니다.

중복 작업 공간을 시작하기 위한 URL 매개변수는 다음과 같습니다.

https://<openshift_dev_spaces_fqdn>#<git_repository_url>?new
참고

현재 URL을 사용하여 시작한 작업 공간이 있는 경우 URL 매개변수 없이 URL을 다시 방문하면 오류 메시지가 표시됩니다.

1.1.1.5. devfile 파일 이름에 대한 URL 매개변수

새 작업 공간을 시작하기 위해 URL을 방문하면 OpenShift Dev Spaces에서 파일 이름 .devfile.yaml 또는 devfile.yaml 을 사용하여 devfile의 연결된 Git 리포지토리를 검색합니다. 연결된 Git 리포지토리의 devfile은 이 file-naming 규칙을 따라야 합니다.

경우에 따라 devfile에 대해 서로 다르고 일치하지 않는 파일 이름을 지정해야 할 수 있습니다.

devfile의 일관되지 않은 파일 이름을 지정하는 URL 매개변수는 df= <filename> . yaml 입니다.

https://<openshift_dev_spaces_fqdn>#<git_repository_url>?df=<filename>.yaml 
1
1
<filename > .yaml 은 연결된 Git 리포지토리에 있는 devfile의 일관되지 않은 파일 이름입니다.
작은 정보

df= <filename > .yaml 매개변수에도 긴 버전: devfilePath= <filename > .yaml 이 있습니다.

1.1.1.6. devfile 파일 경로에 대한 URL 매개변수

새 작업 공간을 시작하기 위해 URL을 방문하면 OpenShift Dev Spaces는 연결된 Git 리포지토리의 루트 디렉터리를 파일 이름 .devfile.yaml 또는 devfile.yaml 을 사용하여 devfile을 검색합니다. 연결된 Git 리포지토리에 있는 devfile의 파일 경로는 이 경로 규칙을 따라야 합니다.

연결된 Git 리포지토리에서 devfile에 대한 다른 비충분한 파일 경로를 지정해야 하는 경우도 있습니다.

devfile의 일관되지 않은 파일 경로를 지정하는 URL 매개변수는 devfilePath= <relative_file_path >입니다.

https://<openshift_dev_spaces_fqdn>#<git_repository_url>?devfilePath=<relative_file_path> 
1
1
<relative_file_path >는 연결된 Git 리포지토리에 있는 devfile의 일관되지 않은 파일 경로입니다.

1.1.1.7. 작업 공간 스토리지에 대한 URL 매개변수

새 작업 공간을 시작하기 위한 URL에 스토리지 유형을 지정하는 URL 매개 변수가 없으면 CheCluster 사용자 정의 리소스에서 기본 스토리지 유형으로 정의된 임시 또는 영구 스토리지로 새 작업 공간이 생성됩니다.

작업 공간에 스토리지 유형을 지정하는 URL 매개변수는 storage Type= <storage_type >입니다.

https://<openshift_dev_spaces_fqdn>#<git_repository_url>?storageType=<storage_type> 
1
1
가능한 &lt ;storage_type> 값은 다음과 같습니다.
  • 임시
  • 사용자별 (영구)
  • 작업당 (persistent)
작은 정보

임시 또는 작업별 스토리지 유형을 사용하면 여러 작업 공간을 동시에 실행할 수 있으며 기본 사용자당 스토리지 유형은 사용할 수 없습니다.

1.1.1.8. 추가 원격에 대한 URL 매개변수

새 작업 공간을 시작하기 위해 URL을 방문하면 OpenShift Dev Spaces는 원본 원격을 조직의 OpenShift Dev Spaces 인스턴스의 FQDN URL 뒤에 # 로 지정한 Git 리포지토리로 구성합니다.

작업 공간에 대한 추가 원격 복제 및 구성을 위한 URL 매개변수는 remotes=:입니다.

https://<openshift_dev_spaces_fqdn>#<git_repository_url>?remotes={{<name_1>,<url_1>},{<name_2>,<url_2>},{<name_3>,<url_3>},...}
중요
  • 추가 원격의 이름 원본 을 입력하지 않으면 의 원격 이 복제되고 origin 이라는 이름이 기본적으로 지정되고 예상되는 분기가 자동으로 확인됩니다.
  • 추가 원격 중 하나에 대한 이름 원본 을 입력하면 기본 분기가 자동으로 선택되지만 의 원격은 작업 공간에 대해 복제되지 않습니다.

1.1.1.9. 컨테이너 이미지의 URL 매개변수

다음 시나리오에서 image 매개변수를 사용하여 컨테이너 이미지에 대한 사용자 정의 참조를 사용할 수 있습니다.

  • Git 리포지토리에는 devfile이 없으며 사용자 지정 이미지로 새 작업 공간을 시작하려고 합니다.
  • Git 리포지토리에는 devfile이 포함되어 있으며 devfile의 구성 요소 섹션에 나열된 첫 번째 컨테이너 이미지를 재정의하려고 합니다.

컨테이너 이미지 경로의 URL 매개변수는 image=:입니다.

https://<openshift_dev_spaces_fqdn>#<git_repository_url>?image=<container_image_url>

https:// &lt;openshift_dev_spaces_fqdn&gt; #https://github.com/eclipse-che/che-docs?image=quay.io/devfile/universal-developer-image:ubi8-latest

1.1.1.10. 메모리 제한에 대한 URL 매개변수

devfile URL에서 새 작업 공간을 시작할 때 memoryLimit 매개변수를 사용하여 컨테이너 메모리 제한을 지정하거나 덮어쓸 수 있습니다. 이 기능은 작업 공간에 개발 작업에 할당된 메모리가 충분한지 확인하려는 경우 유용합니다.

메모리 제한의 URL 매개변수는 memoryLimit=:입니다.

https://<openshift_dev_spaces_fqdn>#<git_repository_url>?memoryLimit=<container_memory_limit>

메모리 제한을 바이트 단위로 지정하거나 Mi for mebibytes 또는 Gi 와 같은 접미사를 사용할 수 있습니다.

예 1.7. 예

https:// &lt;openshift_dev_spaces_fqdn&gt; #https://github.com/eclipse-che/che-docs?memoryLimit=4Gi

중요

memoryLimit 매개변수를 지정하면 devfile의 첫 번째 컨테이너에 대해 정의된 메모리 제한을 덮어씁니다.

대상 devfile 및 편집기 정의의 제한 합계는 작업 공간 Pod spec.containers[0].resources.limits.memory 에 적용됩니다.

추가 리소스

1.1.1.11. CPU 제한에 대한 URL 매개변수

devfile URL에서 새 작업 공간을 시작할 때 cpuLimit 매개변수를 사용하여 컨테이너 CPU 제한을 지정하거나 덮어쓸 수 있습니다. 이 기능은 작업 공간에 개발 작업에 할당된 메모리가 충분한지 확인하려는 경우 유용합니다.

CPU 제한의 URL 매개변수는 cpuLimit=:입니다.

https://<openshift_dev_spaces_fqdn>#<git_repository_url>?cpuLimit=<container_cpu_limit>

코어에서 CPU 제한을 지정할 수 있습니다.

예 1.8. 예

https://<openshift_dev_spaces_fqdn>#https://github.com/eclipse-che/che-docs?cpuLimit=2

중요

cpuLimit 매개변수를 지정하면 devfile의 첫 번째 컨테이너에 대해 정의된 CPU 제한을 덮어씁니다.

대상 devfile 및 편집기 정의의 제한 합계는 작업 공간 Pod spec.containers[0].resources.limits.cpu 에 적용됩니다.

추가 리소스

Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2026 Red Hat
맨 위로 이동