유효성 검사 테스트 문제 해결

커스텀 VM 이미지가 올바르게 부팅되고 구성 요구사항을 충족하는지 확인하기 위해 Image Builder는 임시 테스트 VM에서 자동 검증 테스트를 실행합니다. 이러한 테스트 중 하나가 실패하면 파이프라인이 중지되고 Image Builder가 최종 이미지를 게시하지 않습니다.

시작하기 전에

  • 아직 인증을 설정하지 않았다면 설정합니다. 인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인합니다. 로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음 옵션 중 하나를 선택하여 Compute Engine에 인증하면 됩니다.

    이 페이지의 샘플 사용 방법에 대한 탭을 선택하세요.

    콘솔

    Google Cloud 콘솔을 사용하여 Google Cloud 서비스 및 API에 액세스하는 경우 인증을 설정할 필요가 없습니다.

    gcloud

    1. Google Cloud CLI를 설치합니다. 설치 후 다음 명령어를 실행하여 Google Cloud CLI를 초기화합니다. 

      gcloud init

      외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.

  • 기본 리전 및 영역을 설정합니다.

    • REST

    로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.

      Google Cloud CLI를 설치합니다.

      외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.

    자세한 내용은 Google Cloud 인증 문서의 REST 사용을 위한 인증을 참조하세요.

개요

맞춤설정 단계가 성공적으로 완료되면 오케스트레이터가 VM 부팅 디스크를 임시 테스트 이미지 (image-builder-test-images 계열에서 image-builder-test-image-BUILD_ID로 명명됨)로 내보냅니다.

오케스트레이터는 이 이미지에서 테스트 VM을 부팅하고 시스템 테스트 모음을 실행합니다. Image Builder는 테스트 결과를 표준 JUnit XML 형식으로 Cloud Build 로그에 직접 출력합니다.

특정 검증 테스트 문제 해결

각 유효성 검사 테스트의 일반적인 실패 및 진단 단계를 검토하세요.

Intel IDPF 드라이버 확인

이 테스트는 지원되는 VM 인스턴스가 실제 네트워크 인터페이스에 고성능 Intel 인프라 데이터 경로 함수 (idpf) 드라이버를 로드하는지 확인합니다.

  • 실패 조건: VM이 일반 네트워크 어댑터 패키지로 되돌아가거나 게스트 커널에 활성 idpf 드라이버 모듈이 없는 경우 VM의 유효성 검사가 실패합니다.
  • 해상도:
    • 기본 운영체제의 커널 버전이 IDPF와 호환되는지 확인합니다.
    • 표준 네트워크 유틸리티가 드라이버를 삭제하거나 차단 목록에 추가하지 않는지 확인합니다.
    • 맞춤 커널 빌드의 경우 CONFIG_IDPF가 구성되어 있는지 확인합니다.

네트워킹 및 게스트 에이전트 확인

이 테스트는 인스턴스에 작동하는 게스트 통신과 표준화된 네트워크 인터페이스 구성이 있는지 확인합니다.

  • 실패 조건: 다음 조건 중 하나에서 테스트가 실패합니다.
    • 게스트 에이전트 서비스 관리자 SubState에 running 상태가 표시되지 않습니다.
    • 비루프백 네트워크 인터페이스가 온라인 상태가 아닙니다.
    • 인터페이스 이름이 예상 표준 패턴 (예: eth* 또는 en*)과 일치하지 않습니다.

  • 해결 방법:

    • 게스트 에이전트가 설치되어 있고 부팅 시 시작되도록 구성되어 있는지 확인합니다.

      systemctl is-active google-guest-agent

    • 네트워크 구성 (예: netplan 또는 ifupdown 템플릿)에서 기본 가상 인터페이스를 사용 중지하지 않는지 확인합니다.

보안 부팅 확인

이 테스트는 UEFI 보안 부팅이 활성 상태이고 시스템이 이미지에서 게스트 OS 커널 서명 유효성 검사를 적용하는지 확인합니다.

  • 실패 조건: Compute Engine UEFI 변수가 SecureBoot이 1이 아니거나 SetupMode이 0이 아니라고 보고하면 테스트가 실패합니다.

  • 해결 방법:

    • 이미지에 유효한 서명 키가 포함되어 있는지 확인합니다.

    • imagebuilder.yaml 파일에서 guestOsFeatures에 대상 블록 아래에 UEFI_COMPATIBLE이 포함되어 있는지 확인합니다.

      destinations:
  - diskImage:
      guestOsFeatures:
        - UEFI_COMPATIBLE

인증 일시중지 또는 재개

이 테스트는 Compute Engine API를 사용하여 테스트 VM을 일시 중지하고 VM 실행이 재개된 후 게스트 전체 재부팅을 트리거하지 않고 연결이 복원되는지 확인합니다.

  • 실패 조건: 인스턴스가 절전 모드에서 깨어날 때 재부팅되거나, 일시 중지 중에 멈추거나, 네트워크 핑을 복구하지 못하면 테스트가 실패합니다.
  • 해상도:
    • 게스트 운영체제의 ACPI 서비스와 전원 정책이 사용 설정되어 있고 ACPI 이벤트에 응답하도록 구성되어 있는지 확인합니다.
    • 게스트 시스템 로그 (/var/log/syslog 또는 /var/log/messages)를 검사하여 맞춤 데몬이 시스템 절전 모드 요청을 차단하는지 확인합니다.

유효성 검사 테스트 건너뛰기

프로덕션 이미지를 검증하는 것이 좋지만 imagebuilder.yaml 파일의 spec.config 블록에서 skipSystemTests: true을 설정하여 테스트 중에 검증 테스트를 건너뛸 수 있습니다.

spec:
  config:
    skipSystemTests: true