IBM Cloud Container Registry의 이미지에서 앱 워크로드 배치

Code Engine으로 IBM Cloud® Container Registry에 있는 이미지를 사용하는 앱을 배치하십시오. 앱은 콘솔 또는 CLI에서 작성할 수 있습니다.

시작하기 전에

IBM Cloud® Container Registry에 이미지가 있어야 합니다. 자세한 정보는 Container Registry 시작하기를 참조하십시오. 또는 저장소 소스 또는 로컬 소스에서 이미지를 빌드할 수 있습니다.
레지스트리에 액세스할 수 있는지 확인하십시오. 컨테이너 레지스트리에 대한 권한 설정을 참조하십시오.

프로젝트의 모든 사용자가 레지스트리 시크릿을 수동으로 생성할 필요 없이 Container Registry 에 이미지를 저장하고 액세스할 수 있도록 프로젝트를 구성하고 싶으신가요? 충분한 권한을 사용하여 위치 (지역) 별로 이 기본 레지스트리 액세스를 구성할 수 있습니다. 이러한 조치를 수행할 수 있는 충분한 권한이 없는 경우 이 페이지를 사용하면 필수 권한을 이해하는 데 도움이 됩니다. 프로젝트 전체 설정 구성 을 참조하십시오.

콘솔을 사용하여 Container Registry의 이미지를 참조하는 앱 배치

Code Engine 콘솔을 사용하여 Container Registry의 이미지를 사용하는 애플리케이션을 배치하십시오.

Code Engine은 계정에 있는 Container Registry 네임스페이스로부터 이미지를 자동으로 가져올 수 있습니다. 다른 Container Registry 계정 또는 개인용 Docker Hub 계정에서 이미지를 가져오려면 개인용 레지스트리의 이미지에서 애플리케이션 워크로드 배치를 참조하십시오.

Code Engine 콘솔을 여십시오.
'만들기 시작'을 선택하세요.
사용 가능한 프로젝트 목록에서 프로젝트를 선택하십시오. 프로젝트를 새로 작성할 수도 있습니다. 앱을 배치하려면 선택한 프로젝트가 있어야 합니다.
애플리케이션을 선택하십시오.
애플리케이션의 이름을 입력하십시오(예: helloapp). 프로젝트 내에서 고유한 애플리케이션 이름을 사용하십시오.
'기존 컨테이너 이미지 사용'을 선택한 다음 '이미지 구성'을 클릭합니다.
IBM Registry Dallas 과 같은 컨테이너 레지스트리 위치를 선택하세요.
레지스트리 시크릿에 대해 Code Engine managed secret 를 선택하십시오. 이 예제에서는 사용자의 계정 내 Container Registry 네임스페이스에 있는 이미지를 사용하므로, Code Engine 에서 레지스트리 시크릿을 자동으로 생성하고 관리해 줍니다.
Code Engine 앱에서 참조할 기존 네임스페이스 및 레지스트리의 이미지 이름을 선택하십시오. 예를 들어 mynamespace를 선택하고 해당 네임스페이스에서 hello_repo 이미지를 선택하십시오.
태그 값을 선택하십시오(예: latest).
완료를 클릭하십시오.
앱에 대한 런타임 설정 또는 환경 변수를 수정하십시오. 이러한 옵션에 대한 자세한 정보는 앱의 엔드포인트 가시성 옵션 및 앱 배치 옵션을 참조하십시오.
작성을 클릭하여 애플리케이션을 작성하십시오.
애플리케이션 상태가 준비로 변경되면 애플리케이션을 테스트할 수 있습니다. 애플리케이션 테스트를 클릭한 후 애플리케이션 테스트 분할창에서 요청 전송을 클릭하십시오. 애플리케이션을 웹 페이지에서 열려면 애플리케이션 URL을 클릭하십시오.

애플리케이션을 배치했으므로 애플리케이션 개정, 실행 중인 인스턴스 및 구성 세부사항에 대한 정보를 확인할 수 있습니다.

자신의 계정에 없는 Container Registry 인스턴스에 대한 레지스트리 액세스 권한을 추가하려면 Container Registry에 대한 액세스 권한 추가를 참조하십시오.

CLI를 사용하여 Container Registry의 이미지로 앱 배치

CLI에서 ibmcloud ce app create 명령을 사용하여 IBM Cloud® Container Registry의 이미지를 사용하는 애플리케이션을 배치하십시오. 전체 옵션 목록은 ibmcloud ce app create 명령을 참조하십시오.

시작하기 전에

Code Engine CLI 환경을 설정하십시오.
프로젝트를 작성하고 작업하십시오.
Container Registry의 이미지를 참조하는 Code Engine 애플리케이션에 대해 작업하려면 먼저 레지스트리에 대한 액세스 권한을 추가해야 앱이 배치될 때 Code Engine에서 이미지를 가져올 수 있습니다. 이미지 레지스트리에 액세스하는 데 필요한 권한에 대한 정보는 이미지 레지스트리의 권한 설정을 참조하십시오.

Container Registry에 대한 액세스 권한을 추가하려면 IAM API 키를 작성하십시오. CLI로 IBM Cloud IAM API 키를 작성하려면 iam api-key-create 명령을 실행하십시오. 예를 들어, 설명이 My CLI API key 인 cliapikey 라는 API 키를 생성하여 key_file 라는 파일에 저장하려면 다음 명령을 실행하십시오:
```
ibmcloud iam api-key-create cliapikey -d "My CLI API key" --file key_file
```
키를 파일에 저장하지 않도록 선택한 경우 키를 작성할 때 표시되는 API 키를 기록해 두어야 합니다. 나중에 검색할 수 없습니다.
API 키를 작성한 후 Code Engine에 대한 레지스트리 액세스를 추가하십시오. CLI를 사용하여 Container Registry 에 대한 액세스를 추가하려면 ibmcloud ce secret create --format registry 명령을 사용하여 레지스트리 시크릿을 작성하십시오. 예를 들어, 다음 명령어는 myregistry 라는 Container Registry 인스턴스에 대한 레지스트리 액세스 권한을 생성합니다. --server 및 --username 옵션이 예제 명령에 지정되어 있더라도 서버가 --server인 경우 us.icr.io 옵션의 기본값은 --username이고 iamapikey 옵션의 기본값은 us.icr.io입니다.
```
ibmcloud ce secret create --format registry --name myregistry --server us.icr.io --username iamapikey --password APIKEY
```
출력 예
```
Creating registry secret 'myregistry'...
OK
```
앱을 작성하고 Container Registry에 있는 hello_repo 이미지를 참조하십시오. 예를 들어, ibmcloud ce app create 명령을 사용하여 myhelloapp 액세스 정보의 사용을 통해 us.icr.io/mynamespace/hello_repo를 참조하도록 myregistry 앱을 작성하십시오.
```
ibmcloud ce app create --name myhelloapp --image us.icr.io/mynamespace/hello_repo --registry-secret myregistry
```
이 애플리케이션의 이미지 이름 형식은 REGISTRY/NAMESPACE/REPOSITORY:TAG입니다. 여기서 REGISTRY 및 TAG는 선택사항입니다. REGISTRY를 지정하지 않으면 기본값은 docker.io입니다. TAG를 지정하지 않으면 기본값은 latest입니다.
앱을 배치한 후에는 앱에 액세스할 수 있습니다. 앱의 URL을 확보하려면 ibmcloud ce app get --name myhelloapp --output url을 실행하십시오. myhelloapp 앱에 대해 curl을 실행하면 Hello World가 리턴됩니다.
```
curl https://myhelloapp.abcdabcdhye.us-south.codeengine.appdomain.cloud
```

다음 단계

앱이 배치되면 URL을 통해 앱에 액세스하십시오.
사용자 정의 도메인 맵핑 을 작성하여 앱에 지정할 수 있습니다. 사용자 정의 도메인 이름을 사용하여 여러 지역에 앱을 배치하는 방법에 대한 자세한 정보는 고가용성 애플리케이션 구성 을 참조하십시오.
앱이 배포되었으니, 이제 앱을 이벤트 기반 방식으로 전환하는 것을 고려해 보세요. 이벤트 구독을 사용하여 주기적 스케줄 로 앱을 트리거하거나 파일 업로드 또는 Kafka 메시지 와 같은 이벤트에 반응하도록 앱을 설정할 수 있습니다.

앱이 배치되면 앱 작성 방식이나 이전의 업데이트 방식에 관계없이 다음 방법 중 하나로 배치된 앱을 업데이트하고 참조 코드를 업데이트할 수 있습니다.

Open Container Initiative(OCI)표준에 부합하는 컨테이너 이미지가 있다면, 앱을 배포할 때 해당 이미지의 참조 정보만 제공하면 되며, 이 참조 정보는 컨테이너 레지스트리의 위치를 가리키게 됩니다. 공용 레지스트리 또는 개인용 레지스트리 의 이미지를 사용하여 앱을 배치할 수 있습니다.

app create 명령을 사용하여 앱을 작성하고 로컬 또는 저장소 소스에서 컨테이너 이미지를 빌드하도록 --build-source 옵션을 지정했으며 다른 컨테이너 이미지를 가리키도록 앱을 변경하려는 경우에는 먼저 앱에서 빌드의 연관을 제거해야 합니다. 예를 들어, ibmcloud ce application update -n APP_NAME --build-clear 를 실행하십시오. 앱에서 빌드의 연관을 제거한 후 다른 이미지를 참조하도록 앱을 업데이트할 수 있습니다.
Git 저장소에 있는 소스 코드로 시작하는 경우, Code Engine에서 한 번의 오퍼레이션으로 소스에서 이미지를 빌드하고 앱을 배치하도록 선택할 수 있습니다. 이 경우 Code Engine은 이미지를 IBM Cloud® Container Registry에 업로드합니다. 자세한 정보는 저장소 소스 코드에서 앱 배치를 참조하십시오. 이미지 빌드를 더 많이 제어하려면 앱을 배치하기 전에 Code Engine을 사용하여 이미지를 빌드하도록 선택할 수 있습니다.
로컬 워크스테이션에 있는 소스 코드로 시작하는 경우, Code Engine에서 하나의 CLI 명령으로 소스에서 이미지를 빌드하고 앱을 배치하도록 선택할 수 있습니다. 이 경우 Code Engine은 이미지를 IBM Cloud® Container Registry에 업로드합니다. 자세한 정보는 CLI를 사용하여 로컬 소스 코드에서 앱 배치를 참조하십시오. 이미지 빌드를 더 많이 제어하려면 앱을 배치하기 전에 Code Engine을 사용하여 이미지를 빌드하도록 선택할 수 있습니다.

예를 들어, 사용자가 앱에 대한 소스 개발을 진행하는 동안 Code Engine에서 로컬 소스의 빌드를 처리하도록 선택할 수 있습니다. 그런 다음 이미지가 만기되면 원하는 특정 이미지를 참조하도록 배치된 앱을 업데이트할 수 있습니다. 이 프로세스는 필요에 따라 반복할 수 있습니다.

업데이트된 앱을 배치할 때 이미지에 대해 태그를 지정하지 않는 한 참조된 컨테이너 이미지의 최신 버전이 다운로드되어 배치됩니다. 이미지에 대해 태그를 지정한 경우 태그 지정된 이미지가 배치에 사용됩니다.

더 많은 코드 예를 찾고 계십니까? IBM Cloud Code Engine GitHub 저장소의 예제를 확인해 보세요.