1장. Dev Spaces 시작하기


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

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

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>
    Copy to Clipboard Toggle word wrap
    작은 정보

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

    https://<openshift_dev_spaces_fqdn>#<git_repository_url>?<optional_parameters> 
    1
    Copy to Clipboard Toggle word wrap
    작은 정보

    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
Copy to Clipboard Toggle word wrap
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>
    Copy to Clipboard Toggle word wrap
    Expand
    표 1.1. 지원되는 IDE에 대한 URL 매개변수 <editor_key > 값
    IDE상태<editor_key> value참고

    Microsoft Visual Studio Code - 오픈 소스

    Available

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

    JetBrains 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
    Copy to Clipboard Toggle word wrap
    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>
Copy to Clipboard Toggle word wrap

예제:

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
Copy to Clipboard Toggle word wrap
참고

현재 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
Copy to Clipboard Toggle word wrap
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
Copy to Clipboard Toggle word wrap
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
Copy to Clipboard Toggle word wrap
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>},...}
Copy to Clipboard Toggle word wrap
중요
  • 추가 원격의 이름 원본 을 입력하지 않으면 의 원격 이 복제되고 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>
Copy to Clipboard Toggle word wrap

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

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat