CLI를 사용하여 로컬 소스 코드에서 앱 배치

IBM Cloud® Code Engine CLI를 사용하여 로컬 워크스테이션의 소스 코드에서 직접 애플리케이션을 배치할 수 있습니다. app create 명령을 사용하여 로컬 소스에서 이미지를 빌드하고 이 빌드된 이미지를 참조하도록 애플리케이션을 배치하십시오.

로컬 디렉토리에서 코드를 가져오는 빌드를 제출하면 소스 코드가 아카이브 파일로 압축됩니다. Code Engine은 계정의 IBM Cloud® Container Registry 네임스페이스에 이미지를 자동으로 업로드한 후 이 빌드된 이미지를 참조하도록 앱을 작성합니다. 로컬 빌드의 경우 IBM Cloud Container Registry만 대상으로 지정할 수 있습니다. 소스 이미지는 빌드 이미지와 동일한 네임스페이스에 작성됩니다. 이 경우 앱 이름과 로컬 소스의 경로만 제공하면 됩니다. 전체 옵션 목록은 ibmcloud ce app create 명령을 참조하십시오.

이미지 레지스트리에 액세스하는 데 필요한 권한에 대한 정보는 이미지 레지스트리의 권한 설정을 참조하십시오.

.gitignore 파일과 유사하게 작동하는 .ceignore 파일을 사용하여 소스 코드 내에서 특정 파일 패턴을 무시하도록 선택할 수 있습니다. 예를 들어, node.js 애플리케이션의 .ceignore 파일에 대한 항목에는 node_modules 및 .npm이 포함될 수 있습니다. 무시할 샘플 파일 패턴을 더 보려면 GitHub.gitignore 리포지토리를 참조하세요.

이 경우 IBM Cloud® Container Registry가 필요합니다.

시작하기 전에

• Code Engine CLI 환경을 설정하십시오.
• 프로젝트를 작성하고 작업하십시오.

로컬 소스에 대해 작업하기 전에 소스가 로컬 워크스테이션의 액세스 가능한 위치에 있는지 확인하십시오.

이 예에서는 https://github.com/IBM/CodeEngine 샘플, 특히 helloworld 샘플을 사용합니다.

1. 다음 명령을 사용하여 https://github.com/IBM/CodeEngine 샘플 소스를 로컬 워크스테이션으로 다운로드하십시오.

   git clone https://github.com/IBM/CodeEngine
   

2. CodeEngine\helloworld 디렉토리로 변경하십시오.

3. CodeEngine\helloworld 디렉토리에서 로컬 워크스테이션의 CodeEngine\helloworld 소스에서 빌드된 이미지를 사용하는 myapp-local 앱을 작성하고 배치하십시오. 이 명령은 자동으로 이미지를 빌드한 후 계정의Container Registry 네임스페이스로 푸시합니다. 기존 Container Registry 네임스페이스가 없는 경우 Code Engine에서 자동으로 작성합니다.

   ibmcloud ce application create --name myapp-local --build-source .
   

   .은 빌드 소스가 현재 작업 중인 디렉토리에 있음을 나타냅니다.

   출력 예

   Creating application 'myapp-local'...
   Packaging files to upload from source path '.'...
   Submitting build run 'myapp-local-run-220414-171750199'...
   Creating image 'private.us.icr.io/ce--abcde-glxo4kabcde/app-myapp-local:220414-2117-rdaga'...
   Waiting for build run to complete...
   Build run status: 'Running'
   Build run completed successfully.
   Run 'ibmcloud ce buildrun get -n myapp-local-run-220414-171750199' to check the build run status.
   Waiting for application 'myapp-local' to become ready.
   Configuration 'myapp-local' is waiting for a Revision to become ready.
   Ingress has not yet been reconciled.
   Waiting for load balancer to be ready.
   Run 'ibmcloud ce application get -n myapp-local' to check the application status.
   OK
   
   https://myapp-local.glxo4kabcde.us-south.codeengine.appdomain.cloud
   

   명령의 출력을 살펴보면 application create 명령의 출력은 앱이 생성 및 배포되기 전에 빌드 실행의 진행 상황에 대한 정보를 제공합니다.

   이 예에서는 빌드된 이미지가 Container Registry의 ce--abcde-glxo4kabcde 네임스페이스에 업로드됩니다.

   다음 표에는 이 예에서 app create 명령과 함께 사용되는 옵션이 요약되어 있습니다. 명령 및 해당 옵션에 대한 자세한 정보는 ibmcloud ce app create 명령을 참조하십시오.

   명령 설명

   옵션	설명
   --name	애플리케이션의 이름입니다. 프로젝트 내에서 고유한 이름을 사용하십시오. 이 값은 필수입니다. 이름은 소문자로 시작해야 합니다. 이름은 소문자 영숫자로 끝나야 합니다. 이름은 63자 이하여야 하며 문자, 숫자 및 하이픈(-)을 포함할 수 있습니다.
   --build-source	로컬 소스의 경로입니다.

4. application get 명령을 사용하여 빌드 정보를 포함하여 앱에 대한 정보를 표시하십시오.

   ibmcloud ce application get --name myapp-local
   

   출력 예

   [...]
   Name:          myapp-local
   ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f  
   Project Name:  myproject  
   Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
   Age:           2d15h
   Created:       2022-04-14T16:10:11-04:00
   URL:                https://myapp-local.Sta.us-south.codeengine.appdomain.cloud
   Cluster Local URL:  http://myapp-local.glxo4kabcde.svc.cluster.local
   Console URL:        https://cloud.ibm.com/codeengine/project/us-south/01234567-abcd-abcd-abcd-abcdabcd1111/application/myapp-local/configuration
   Status Summary:  Application deployed successfully
   
   Environment Variables:    
       Type     Name             Value  
       Literal  CE_API_BASE_URL  https://api.private.us-south.codeengine.cloud.ibm.com
       Literal  CE_APP           myapp  
       Literal  CE_DOMAIN        us-south.codeengine.appdomain.cloud  
       Literal  CE_PROJECT_ID    abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
       Literal  CE_REGION        us-south  
       Literal  CE_SUBDOMAIN     abcdabcdab
   Image:                  private.us.icr.io/ce--abcde-glxo4kabcde/app-myapp-local:220414-2010-sqsoj
   Resource Allocation:
     CPU:                1
     Ephemeral Storage:  400M
     Memory:             4G
   Registry Secrets:
     ce-auto-icr-private-us-south
   
   Revisions:
     myapp-local-00001:
       Age:                23m
       Latest:             true
       Traffic:            100%
       Image:              private.us.icr.io/ce--abcde-glxo4kabcde/app-myapp-local:220414-2010-sqsoj (pinned to 86944c)  
       Running Instances:  0
   
   Runtime:
     Concurrency:    100
     Maximum Scale:  10
     Minimum Scale:  0
     Timeout:        300
   
   Build Information:
     Build Run Name:     myapp-local-run-220414-161009244
     Build Type:         git
     Build Strategy:     dockerfile-medium
     Timeout:            600
     Source:             https://github.com/IBM/CodeEngine
     Context Directory:  helloworld
     Dockerfile:         Dockerfile
   
     Build Run Summary:  Succeeded
     Build Run Status:   Succeeded
     Build Run Reason:   All Steps have completed executing
     Run 'ibmcloud ce buildrun get -n myapp-local-run-220414-161009244' for details.
   [...]
   

앱이 로컬 소스 코드에서 작성되어 배치되었으므로 ibmcloud ce app update 명령을 사용하여 필요에 맞게 앱을 업데이트할 수 있습니다. 앱 업데이트에 대한 자세한 정보는 앱 업데이트를 참조하십시오. 앱에 사용할 소스를 업데이트하려면 application update 명령에 --build-source 옵션을 제공해야 합니다.

로컬 소스에서 이미지를 빌드하고 단일 명령으로 앱을 배치하는 대신, 앱을 배치하기 전에 먼저 로컬 소스에서 빌드하도록 선택할 수 있습니다. 로컬 워크스테이션에서 소스를 가져오는 빌드 구성 작성 을 참조하십시오.

앱이 로컬 소스 또는 CLI의 저장소 소스 코드 에서 배치되는 경우 결과 빌드 실행은 빌드 구성을 기반으로 하지 않습니다. 완료된 빌드 실행은 결국 자동으로 삭제됩니다. 빌드 실행이 성공하면 빌드 구성을 기반으로 하지 않는 빌드 실행이 1시간후에 삭제됩니다. 빌드 실행이 실패하면 이 빌드 실행은 24시간후에 삭제됩니다. CLI를 사용하여 이 빌드 실행에 대한 정보만 표시할 수 있습니다. 콘솔에서 이 빌드 실행을 볼 수 없습니다.