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 리포지토리 복제본으로 새 작업 공간을 시작하려면 다음을 수행합니다.
- 선택 사항: OpenShift Dev Spaces 대시보드 페이지를 방문하여 조직의 OpenShift Dev Spaces 인스턴스에 인증합니다.
URL을 방문하여 기본 구문을 사용하여 새 작업 공간을 시작합니다.
https://<openshift_dev_spaces_fqdn>#<git_repository_url>
https://<openshift_dev_spaces_fqdn>#<git_repository_url>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 작은 정보선택적 매개변수를 사용하여 이 URL을 확장할 수 있습니다.
https://<openshift_dev_spaces_fqdn>#<git_repository_url>?<optional_parameters>
https://<openshift_dev_spaces_fqdn>#<git_repository_url>?<optional_parameters>
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow 작은 정보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:// <openshift_dev_spaces_fqdn> #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> #https://github.com/che-samples/cpp-hello-world ?new&che-editor=che-incubator/intellij-community/latest&devfilePath=tests/testdevfile.yaml
https://<openshift_dev_spaces_fqdn>
#https://github.com/che-samples/cpp-hello-world
?new&che-editor=che-incubator/intellij-community/latest&devfilePath=tests/testdevfile.yaml
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>
https://<openshift_dev_spaces_fqdn>#<git_repository_url>?che-editor=<editor_key>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Expand 표 1.1. 지원되는 IDE에 대한 URL 매개변수 <editor_key > 값 IDE 상태 <editor_key>
value참고 Available
-
che-incubator/che-code/latest
-
che-incubator/che-code/insiders
-
latest
는 URL 매개변수 또는che-editor.yaml
을 사용하지 않을 때 새 작업 공간에 로드되는 기본 IDE입니다. -
내부자
는 개발 버전입니다.
더 이상 사용되지 않음
-
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>
https://<openshift_dev_spaces_fqdn>#<git_repository_url>?che-editor=<url_to_a_file>
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- devfile 콘텐츠 가 있는 파일의 URL입니다.
작은 정보- URL은 원시 파일 콘텐츠를 가리켜야 합니다.
-
이 매개변수를
che-editor.yaml
파일과 함께 사용하려면 다른 이름 또는 경로가 있는 파일을 복사한 다음 파일에서인라인
으로 행을 제거합니다.
- che-editors.yaml 파일에 는 지원되는 모든 IDE의 devfile이 있습니다.
1.1.1.3. IDE 이미지의 URL 매개변수 링크 복사링크가 클립보드에 복사되었습니다!
editor-image
매개변수를 사용하여 작업 공간에 대한 사용자 지정 IDE 이미지를 설정할 수 있습니다.
-
Git 리포지토리에
/.che/che-editor.yaml
파일이 포함된 경우 사용자 지정 편집기가 새 IDE 이미지로 재정의됩니다. -
Git 리포지토리에
/.che/che-editor.yaml
파일이 없으면 기본 편집기가 새 IDE 이미지로 재정의됩니다. -
지원되는 IDE를 재정의하고 대상 편집기 이미지를 변경하려면
che-editor
및editor-image
URL 매개변수를 모두 함께 사용할 수 있습니다.
IDE 이미지를 재정의하는 URL 매개변수는 editor-image=
:입니다.
https://<openshift_dev_spaces_fqdn>#<git_repository_url>?editor-image=<container_registry/image_name:image_tag>
https://<openshift_dev_spaces_fqdn>#<git_repository_url>?editor-image=<container_registry/image_name:image_tag>
예제:
https:// <openshift_dev_spaces_fqdn> #https://github.com/eclipse-che/che-docs?editor-image=quay.io/che-incubator/che-code:next
또는
https:// <openshift_dev_spaces_fqdn> #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
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
https://<openshift_dev_spaces_fqdn>#<git_repository_url>?df=<filename>.yaml
- 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>
https://<openshift_dev_spaces_fqdn>#<git_repository_url>?devfilePath=<relative_file_path>
- 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>
https://<openshift_dev_spaces_fqdn>#<git_repository_url>?storageType=<storage_type>
- 1
- 가능한 <
;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>},...}
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://<openshift_dev_spaces_fqdn>#<git_repository_url>?image=<container_image_url>
예
https:// <openshift_dev_spaces_fqdn> #https://github.com/eclipse-che/che-docs?image=quay.io/devfile/universal-developer-image:ubi8-latest