View a markdown version of this page

AWS PCS용 Amazon EC2 사용자 데이터 작업 - AWS PCS

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS PCS용 Amazon EC2 사용자 데이터 작업

참고

대부분의 노드 구성 작업의 경우 노드 수명 주기 작업을 권장합니다. 스크립트별 오류 처리 및 재부팅 제어를 통해 재사용 가능한 API 네이티브 구성을 제공합니다. AWS PCS 에이전트가 시작되기 전에 실행해야 하는 작업에 시작 템플릿 사용자 데이터를 사용합니다. 자세한 내용은 노드 수명 주기 작업 단원을 참조하십시오.

인스턴스가 시작될 때 cloud-init 실행되는 시작 템플릿에 EC2 사용자 데이터를 제공할 수 있습니다. 콘텐츠 유형의 사용자 데이터 블록은 인스턴스가 AWS PCS API에 등록되기 전에 cloud-config 실행되고 콘텐츠 유형의 사용자 데이터 블록은 등록이 완료된 후 Slurm 데몬이 시작되기 전에 text/x‑shellscript 실행됩니다. 콘텐츠 유형에 대한 자세한 내용은 cloud-init 문서를 참조하세요.

사용자 데이터는 다음을 포함하되 이에 국한되지 않는 일반적인 구성 시나리오를 수행할 수 있습니다.

시작 템플릿의 사용자 데이터는 MIME 멀티파트 아카이브 형식이어야 합니다. 이는 사용자 데이터가 노드 그룹의 노드를 구성하는 데 필요한 다른 AWS PCS 사용자 데이터와 병합되기 때문입니다. 여러 사용자 데이터 블록을 단일 MIME 멀티파트 파일로 결합할 수 있습니다.

MIME 멀티파트 파일은 다음과 같은 구성 요소로 이루어집니다.

  • 콘텐츠 유형 및 부분 경계 선언: Content-Type: multipart/mixed; boundary="==BOUNDARY=="

  • MIME 버전 선언: MIME-Version: 1.0

  • 다음 구성 요소를 포함하는 하나 이상의 사용자 데이터 블록:

    • 사용자 데이터 블록의 시작을 나타내는 시작 경계: --==BOUNDARY== 이 경계 앞의 라인은 비워 두어야 합니다.

    • 블록의 콘텐츠 유형 선언: Content-Type: text/cloud-config; charset="us-ascii" 또는 Content-Type: text/x-shellscript; charset="us-ascii". 콘텐츠 유형 선언 뒤의 라인은 비워 두어야 합니다.

    • 쉘 명령 또는 cloud-config 지시어 목록 등의 사용자 데이터 콘텐츠

  • MIME 멀티파트 파일의 끝을 나타내는 종료 경계: --==BOUNDARY==-- 종료 경계 앞의 라인은 비워 두어야 합니다.

참고

Amazon EC2 콘솔의 시작 템플릿에 사용자 데이터를 추가하는 경우 일반 텍스트로 붙여 넣을 수 있습니다. 또는 파일에서 업로드할 수도 있습니다. AWS CLI 또는 AWS SDK를 사용하는 경우 먼저 사용자 데이터를 base64로 인코딩하고이 JSON 파일에 표시된 대로 CreateLaunchTemplate을 호출할 때 해당 문자열을 UserData 파라미터 값으로 제출해야 합니다.

{
    "LaunchTemplateName": "base64-user-data",
    "LaunchTemplateData": {
        "UserData": "ewogICAgIkxhdW5jaFRlbXBsYXRlTmFtZSI6ICJpbmNyZWFzZS1jb250YWluZXItdm9sdW..."
    }
}
예제