차량 운영

CLI 또는 콘솔로 플릿을 실행하려면 다음 단계를 따르세요. 함대는 생성되는 즉시 실행되므로 running 함대와 creating 함대는 동일한 작업이라는 점에 유의하세요.

시작하기 전에

플릿을 성공적으로 운영하려면 플릿 운영 준비하기의 단계를 따랐는지 확인하세요. 또한 Code Engine 을 사용하여 차량 생성 시 참조하는 이미지를 구축할 수 있습니다.

CLI를 사용하여 함대 운영

다음 예제 명령을 사용하여 함대를 실행합니다. 이 명령은 추가 옵션을 허용합니다. 사용 가능한 모든 명령어 옵션의 전체 목록은 CLI 문서를 참조하세요.

ibmcloud ce fleet run --name my-fleet --image icr.io/codeengine/helloworld --subnetpool-name my-pool --tasks-state-store mytaskstore --tasks 1
--name
Fleet의 이름입니다. 이 값은 동일한 프로젝트 내의 모든 플릿에서 고유해야 합니다. 차량 이름을 지정하지 않으면 임의의 차량 이름이 생성됩니다.
--image
작업 처리에 사용되는 컨테이너 이미지의 이름입니다. 이 값은 _필수_입니다.
--subnetpool-name
플릿 네트워크 배치에 사용할 서브넷 풀의 이름입니다.
--tasks-state-store
차량의 작업 상태를 저장하는 영구 데이터 저장소를 지정합니다. 이 값은 _필수_입니다.
--tasks
실행할 작업 수입니다.

출력 예.

Successfully created fleet with name 'my-fleet' and ID '1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e'
Run 'ibmcloud ce fleet get --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e' to check the fleet status.
Run 'ibmcloud ce fleet worker list --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e' to retrieve a list of provisioned workers.
Run 'ibmcloud ce fleet task list --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e' to retrieve a list of tasks.
OK

콘솔을 사용하여 차량 운영

Code Engine 콘솔에서 플릿을 실행하려면 다음 단계를 따르세요.

  1. 콘솔을 엽니다 Code Engine 콘솔을 엽니다.
  2. 작성 시작을 클릭하십시오.
  3. 사용 가능한 프로젝트 목록에서 프로젝트를 선택하십시오. 프로젝트를 새로 작성할 수도 있습니다. 플릿을 실행하려면 선택한 프로젝트가 있어야 합니다.
  4. 함대를 생성하는 옵션을 선택합니다.
  5. 함대의 이름을 지정하십시오. 프로젝트 내의 모든 차량에서 이름이 고유한지 확인하세요.
  6. 차량에 대한 컨테이너 이미지를 지정합니다(예: icr.io/codeengine/helloworld). 컨테이너 이미지로 변환하려는 자체 소스 코드가 있는 경우 빌드 계획하기를 참조하세요. 이 예제에서 사용된 코드에 대한 자세한 내용은 helloworld를 참조하십시오.
  7. 지시에 따라 차량을 구성하세요.
  8. 작업 섹션에서 차량에 대한 작업 지정 방법을 구성합니다. 자세한 내용은 작업 사양을 참조하세요.
  9. 리소스 및 확장 섹션에서 인스턴스 리소스를 구성하고 인스턴스 확장 또는 축소 방법을 지정합니다.
  10. 네트워크 배치 섹션에서 서브넷 풀 선택을 클릭합니다.
    1. 새 서브넷 풀을 생성하여 이 차량의 작업자의 네트워크 배치를 지정합니다. 자세한 내용은 Code Engine 에서 서브넷 풀 연결 작업을 참조하세요.
    2. 또는 하나 이상의 기존 서브넷 풀을 선택하여 이 플릿의 작업자의 네트워크 배치를 지정할 수 있습니다.
    3. ‘적용’을 클릭하여 선택을 확인하세요.
  11. 환경 변수 및 볼륨 마운트 섹션에서 실행 중인 코드에서 사용할 수 있는 선택적 키-값 쌍, 구성 맵 또는 추가 파일을 추가합니다.
  12. 작성을 클릭하십시오.

작업 사양

함대에는 항상 하나 이상의 작업이 있지만 훨씬 더 많은 수의 작업이 있을 수 있습니다. 완료할 작업 수, 한 번에 실행할 작업 인스턴스 수, 작업이 완료되는 순서를 지정할 수 있습니다. 플릿을 실행하면 완료할 작업의 수에 따라 작업자 노드가 자동으로 확장됩니다.

다음과 같은 방법으로 작업을 지정할 수 있습니다:

  • 작업 수입니다: 특정 작업 수를 실행하려면 양의 정수를 지정할 수 있습니다. CLI에서 --tasks 옵션을 사용합니다. UI에서 작업 수 을 선택하고 실행할 번호를 입력합니다.
  • 작업 색인: 작업 범위를 지정하려면 쉼표로 구분된 범위 목록과 양의 정수를 포함하는 작업 인덱스(예: 2-5,7-8,10)를 지정할 수 있습니다. CLI에서 --task-indexes 옵션을 사용합니다. UI에서 작업 인덱스를 선택하고 범위를 입력합니다.
  • 작업 파일: 다른 명령이나 인수를 사용하여 다른 작업을 실행하려면 이미지 정의를 재정의하는 작업 사양 파일을 만들 수 있습니다. 선택 사항인 idx 필드를 사용하여 사용자 지정 작업 인덱스를 지정할 수 있습니다. 이 파일은 JSONL 형식으로 변환되어야 합니다. CLI에서 --tasks-from-local-file 또는 --tasks-from-cos-object 옵션으로 파일을 지정합니다. UI에서 파일에서 작업을 선택하고 파일 이름을 지정합니다. 아래에서 작업 명세 파일에 추가할 수 있는 줄의 예를 참조하세요.

작업 명세서 파일의 예시 줄입니다.

{ "cmds": ["my", "multipart", "command"], "args": ["arg1", "arg2"] }
{ "cmds": ["other", "cmd"], "args": ["arg"], "idx": "foo" }
{ "args": ["argA", "argB", "argC"], "idx": "bar" }
{ "cmds": ["just", "another", "command"], "idx": "1234" }

CLI를 사용하여 함대 삭제하기

함대는 최종 상태에 도달해도 자동으로 삭제되지 않습니다. 프로젝트당 1000개의 플릿이 할당량 제한이 있으므로( 프로젝트 할당량 참조), 더 이상 필요하지 않은 경우 CLI를 사용하여 플릿을 삭제하세요.

다음 예제 명령을 사용하여 함대를 삭제할 수 있습니다. 이 명령은 추가 옵션을 허용합니다. 사용 가능한 모든 명령어 옵션의 전체 목록은 CLI 문서를 참조하세요.

ibmcloud ce fleet delete --force --fleet-id 1a1a1a1a-2b2b-3c3c-4d4d-5e5e5e5e5e5e

콘솔을 사용하여 함대 삭제하기

함대는 최종 상태에 도달해도 자동으로 삭제되지 않습니다. 프로젝트당 1000개의 플릿이 할당량 제한이 있으므로( 프로젝트 할당량 참조), 더 이상 필요하지 않은 경우 CLI를 사용하여 플릿을 삭제하세요.

콘솔에서 함대를 삭제하려면 다음 단계를 따르세요.

  1. ‘함대’ 페이지로 이동:
    1. Code Engine 콘솔의 프로젝트 페이지에서 프로젝트를 선택합니다.
    2. 함대를 클릭하면 기존 함대 목록을 볼 수 있습니다.
  2. 제거하려는 차량이 있는 행으로 이동하여 삭제(휴지통) 아이콘을 클릭합니다.
  3. 메시지가 표시되면 삭제를 확인합니다.