2.2.2. CLI를 사용하여 애플리케이션 생성
2.2.2.1. 소스 코드에서 애플리케이션 생성
new-app 명령을 사용하면 로컬 또는 원격 Git 리포지토리의 소스 코드에서 애플리케이션을 생성할 수 있습니다.
로컬 디렉터리의 Git 리포지토리를 사용하여 애플리케이션을 생성하려면 다음을 수행합니다.
$ oc new-app /path/to/source/code
로컬 Git 리포지토리를 사용하는 경우 리포지토리에는 OpenShift Container Platform 클러스터에서 액세스할 수 있는 URL을 가리키는 origin 이라는 원격이 있어야 합니다. 인식된 원격이 없는 경우 new-app 은 바이너리 빌드 를 생성합니다.
원격 Git 리포지토리를 사용하여 애플리케이션을 생성하려면 다음을 수행합니다.
$ oc new-app https://github.com/sclorg/cakephp-ex
프라이빗 원격 Git 리포지토리를 사용하여 애플리케이션을 생성하려면 다음을 수행합니다.
$ oc new-app https://github.com/youruser/yourprivaterepo --source-secret=yoursecret
프라이빗 원격 Git 리포지토리를 사용하는 경우 --source-secret 플래그를 사용하여 BuildConfig 에 삽입할 기존 소스 복제 보안을 지정하여 리포지토리에 액세스할 수 있습니다.
--context-dir 플래그를 지정하여 소스 코드 리포지토리의 하위 디렉터리를 사용할 수 있습니다. 원격 Git 리포지토리 및 컨텍스트 하위 디렉터리를 사용하여 애플리케이션을 생성하려면 다음을 수행합니다.
$ oc new-app https://github.com/sclorg/s2i-ruby-container.git \
--context-dir=2.0/test/puma-test-app
또한 원격 URL을 지정하면 URL 끝에 #<branch_name>을 추가하여 사용할 Git 분기를 지정할 수 있습니다.
$ oc new-app https://github.com/openshift/ruby-hello-world.git#beta4
new-app 명령은 소스 코드에서 새 애플리케이션 이미지를 생성하는 빌드 구성 을 생성합니다. 또한 new-app 명령은 일반적으로 새 이미지를 배포하는 배포 구성과 이미지를 실행하는 배포에 부하 분산 액세스 권한을 제공하는 서비스를 생성합니다.
OpenShift Container Platform은 Docker, Pipeline 또는 소스 빌드 전략을 사용해야 하는지 여부를 자동으로 감지하고, 소스 빌드의 경우 적절한 언어 빌더 이미지를 탐지합니다.
빌드 전략 탐지
Jenkinsfile 이 새 애플리케이션을 생성할 때 소스 리포지토리의 루트 또는 지정된 컨텍스트 디렉터리에 있는 경우 OpenShift Container Platform은 Pipeline 빌드 전략을 생성합니다. 그러지 않으면 Dockerfile 이 발견되면 OpenShift Container Platform에서 Docker 빌드 전략을 생성합니다. 그러지 않으면 소스 빌드 전략을 생성합니다.
--strategy 플래그를 docker,pipeline 또는 source 로 설정하여 빌드 전략을 재정의할 수 있습니다.
$ oc new-app /home/user/code/myapp --strategy=docker
oc 명령을 실행하려면 빌드 소스가 포함된 파일이 원격 Git 리포지토리에 제공되어야 합니다. 모든 소스 빌드에 git remote -v를 사용해야 합니다.
언어 탐지
소스 빌드 전략을 사용하는 경우 new-app 은 리포지토리의 루트 또는 지정된 컨텍스트 디렉터리에 특정 파일이 있는지에 따라 사용할 언어 빌더를 결정합니다.
| 언어 | 파일 |
|---|---|
|
| project.json, *.csproj |
|
| pom.xml |
|
| app.json, package.json |
|
| cpanfile, index.pl |
|
| composer.json, index.php |
|
| requirements.txt, setup.py |
|
| Gemfile, Rakefile, config.ru |
|
| build.sbt |
|
| Godeps, main.go |
언어를 탐지한 후 new-app 은 OpenShift Container Platform 서버에서 탐지된 언어와 일치하는 supports 주석이 있는 이미지 스트림 태그 또는 탐지된 언어의 이름과 일치하는 이미지 스트림을 검색합니다. 일치 항목이 없는 경우 new-app은 Docker Hub 레지스트리에서 이름을 기반으로 탐지된 언어와 일치하는 이미지를 검색합니다.
이미지(이미지 스트림 또는 컨테이너 사양) 및 리포지토리를 구분 기호로 지정하여 빌더에서 특정 소스 리포지토리에 사용하는 이미지를 재정의 할 수 있습니다. 이 작업이 완료되면 빌드 전략 탐지 및 언어 탐지 가 수행되지 않습니다.
예를 들어 원격 리포지토리의 소스와 함께 myproject/my-ruby 이미지 스트림을 사용하려면 다음을 실행합니다.
$ oc new-app myproject/my-ruby~https://github.com/openshift/ruby-hello-world.git
로컬 리포지토리의 소스에 openshift/ruby-20-centos7:latest 컨테이너 이미지 스트림을 사용하려면 다음을 실행합니다.
$ oc new-app openshift/ruby-20-centos7:latest~/home/user/code/my-ruby-app
언어 탐지 기능에는 리포지토리를 복제하고 검사할 수 있도록 Git 클라이언트를 로컬에 설치해야 합니다. Git을 사용할 수 없는 경우 <image>~<repository> 구문으로 리포지토리에 사용할 빌더 이미지를 지정하여 언어 탐지 단계가 수행되지 않도록 수 있습니다.
-i <image> <repository> 호출을 사용하려면 new-app 에서 아티팩트 유형이 무엇인지 확인하기 위해 repository 를 복제해야 하므로 Git을 사용할 수 없는 경우 이 작업이 실패합니다.
마찬가지로 -i <image> --code <repository> 호출을 사용하려면 이미지를 소스 코드의 빌더로 사용해야 하는지 아니면 데이터베이스 이미지의 경우와 같이 별도로 배포해야 하는지 확인하기 위해 new-app 에서 repository 를 복제해야 합니다.
