템플릿 동기화 구성 - AWS Proton

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

템플릿 동기화 구성

정의한 등록된 git 리포지토리에 있는 템플릿 번들에서 AWS Proton 동기화할 수 있도록 템플릿을 구성하는 방법을 알아보세요. 커밋이 리포지토리로 푸시되면 AWS Proton 은 리포지토리 템플릿 번들의 변경 사항을 확인합니다. 템플릿 번들 변경이 감지되면 해당 템플릿의 마이너 버전 또는 메이저 버전이 새로 생성됩니다 (해당 버전이 아직 없는 경우). AWS Proton 현재 GitHub, GitHub Enterprise 및 를 BitBucket 지원합니다.

커밋을 동기화된 템플릿 번들로 푸시하기

템플릿 중 하나로 추적되는 브랜치에 커밋을 푸시하면 AWS Proton 은 리포지토리를 복제하고 동기화하는 데 필요한 템플릿을 결정합니다. 디렉토리의 파일을 스캔하여 {template-name}/{major-version}/의 규칙과 일치하는 디렉터리를 찾습니다.

리포지토리 및 브랜치와 관련된 템플릿 및 메이저 버전을 AWS Proton 확인한 후 모든 템플릿을 병렬로 동기화하려고 시도합니다.

특정 템플릿에 동기화할 때마다 는 AWS Proton 먼저 마지막으로 성공한 동기화 이후 템플릿 디렉토리의 내용이 변경되었는지 확인합니다. 내용이 변경되지 않은 경우 중복 번들 등록을 AWS Proton 건너뛰세요. 이렇게 하면 템플릿 번들의 콘텐츠가 변경될 경우 새 템플릿 마이너 버전이 생성됩니다. 템플릿 번들의 콘텐츠가 변경된 경우 번들은 에 등록됩니다. AWS Proton

템플릿 번들이 등록된 후 등록이 완료될 때까지 등록 상태를 AWS Proton 모니터링합니다.

특정 템플릿 마이너 버전과 메이저 버전은 한 번에 한 번만 동기화할 수 있습니다. 동기화가 진행되는 동안 푸시되었을 수 있는 모든 커밋은 일괄 처리됩니다. 일괄 처리된 커밋은 이전 동기화 시도가 완료된 후에 동기화됩니다.

서비스 템플릿 동기화

AWS Proton git 저장소에서 환경 템플릿과 서비스 템플릿을 모두 동기화할 수 있습니다. 서비스 템플릿을 동기화하려면 템플릿 번들의 각 메이저 버전 디렉터리에 이름이 지정된 .template-registration.yaml 추가 파일을 추가합니다. 이 파일에는 커밋 후 서비스 템플릿 버전을 만들 때 AWS Proton 필요한 추가 세부 정보 (호환 환경지원되는 구성 요소 소스) 가 포함되어 있습니다.

파일의 전체 경로는 service-template-name/major-version/.template-registration.yaml입니다. 자세한 내용은 서비스 템플릿 동기화 단원을 참조하세요.

템플릿 동기화 구성 고려 사항

템플릿 동기화 구성 사용에 대한 다음 고려 사항을 검토하세요.

  • 리포지토리는 250MB를 넘지 않아야 합니다.

  • 템플릿 동기화를 구성하려면 먼저 리포지토리를 AWS Proton에 연결합니다. 자세한 정보는 리포지토리로 연결되는 링크를 생성합니다.을 참조하세요.

  • 동기화된 템플릿에서 새 템플릿 버전을 만들면 DRAFT 상태가 됩니다.

  • 다음 중 하나에 해당하는 경우 템플릿의 새 마이너 버전이 생성됩니다.

    • 템플릿 번들 컨텐츠는 마지막으로 동기화된 템플릿 마이너 버전의 컨텐츠와 다릅니다.

    • 이전에 마지막으로 동기화된 템플릿 마이너 버전이 삭제되었습니다.

  • 동기화를 일시 중지할 수는 없습니다.

  • 새 마이너 버전과 메이저 버전 모두 자동으로 동기화됩니다.

  • 템플릿 동기화 구성으로는 새 최상위 템플릿을 만들 수 없습니다.

  • 템플릿 동기화 구성을 사용하면 여러 리포지토리의 템플릿 하나에 동기화할 수 없습니다.

  • 브랜치 대신 태그를 사용할 수는 없습니다.

  • 서비스 템플릿을 만들 때는 호환되는 환경 템플릿을 지정합니다.

  • 환경 템플릿을 만든 다음 동일한 커밋에서 서비스 템플릿과 호환되는 환경으로 추가할 수 있습니다.

  • 단일 템플릿 메이저 버전과의 동기화는 한 번에 하나씩 실행됩니다. 동기화 중에 새 커밋이 감지되면 일괄 처리되어 활성 동기화가 끝날 때 적용됩니다. 다른 템플릿 메이저 버전과의 동기화는 병렬로 이루어집니다.

  • 템플릿이 동기화되는 브랜치를 변경하면 이전 브랜치에서 진행 중인 모든 동기화가 먼저 완료됩니다. 그러면 새 브랜치부터 동기화가 시작됩니다.

  • 템플릿을 동기화하는 데 사용할 리포지토리를 변경하면 이전 리포지토리에서 진행 중인 모든 동기화가 실패하거나 완료될 수 있습니다. 동기화 단계에 따라 다릅니다.

자세한 내용은 AWS Proton 서비스 API 레퍼런스를 참조하십시오.