3장. Jaeger 설치

3.1. Jaeger 설치

다음 두 가지 방법 중 하나로 OpenShift Container Platform에 Jaeger를 설치할 수 있습니다.

  • Jaeger를 Red Hat OpenShift Service Mesh의 일부로 설치할 수 있습니다. Jaeger는 기본적으로 Service Mesh 설치에 포함되어 있습니다. Jaeger를 서비스 메시의 일부로 설치하려면 Red Hat Service Mesh 설치 지침을 따르십시오. Jaeger는 서비스 메시와 동일한 네임스페이스에 설치되어 있어야 합니다. 즉 ServiceMeshControlPlane 및 Jaeger 리소스가 동일한 네임스페이스에 있어야 합니다.
  • 서비스 메시를 설치하지 않으려면 Jaeger Operator를 사용하여 자체적으로 OpenShift Jaeger를 설치할 수 있습니다. 서비스 메시 없이 Jaeger를 설치하려면 다음 지침을 사용하십시오.

3.1.1. 전제 조건

OpenShift Jaeger를 설치하려면 설치 활동을 검토하고 사전 요구 사항을 충족해야 합니다.

3.1.2. Jaeger 설치 개요

OpenShift Jaeger 설치 단계는 다음과 같습니다.

  • 문서를 검토하고 배포 전략을 확인합니다.
  • 배포 전략에 영구 스토리지가 필요한 경우 OperatorHub를 통해 Elasticsearch Operator를 설치합니다.
  • OperatorHub를 통해 Jaeger Operator를 설치합니다.
  • Jaeger YAML 파일을 수정하여 배포 전략을 지원합니다.
  • Jaeger의 인스턴스를 OpenShift Container Platform 환경에 하나 이상 배포합니다.

3.1.3. Elasticsearch Operator 설치

기본 Jaeger 배포는 Jaeger를 평가하거나 설명을 제공하거나 테스트 환경에서 Jaeger를 사용하기 위해 빠르게 설치하도록 설계되었으므로 메모리 내 스토리지를 사용합니다. 프로덕션에서 Jaeger를 사용하려면 영구 스토리지 옵션을 설치하고 구성해야 합니다(이 경우 Elasticsearch).

사전 요구 사항

  • OpenShift Container Platform 웹 콘솔에 액세스합니다.
  • cluster-admin 역할이 있는 계정.
주의

Operator의 커뮤니티 버전은 설치하지 마십시오. 커뮤니티 Operator는 지원되지 않습니다.

참고

이미 Elasticsearch Operator를 OpenShift 클러스터 로깅의 일부로 설치한 경우 Elasticsearch Operator를 다시 설치할 필요가 없습니다. Jaeger Operator는 설치된 Elasticsearch Operator를 사용하여 Elasticsearch 인스턴스를 생성합니다.

프로세스

  1. cluster-admin 역할의 사용자로 OpenShift Container Platform 웹 콘솔에 로그인합니다.
  2. OperatorsOperatorHub로 이동합니다.
  3. Elasticsearch를 필터 상자에 입력하여 Elasticsearch Operator를 찾습니다.
  4. Red Hat에서 제공하는 Elasticsearch Operator를 클릭하여 Operator에 대한 정보를 표시합니다.
  5. 설치를 클릭합니다.
  6. Operator 설치 페이지의 설치 모드에서 클러스터의 모든 네임스페이스(기본값)를 선택합니다. 이렇게 하면 클러스터의 모든 프로젝트에서 Operator를 사용할 수 있습니다.
  7. 설치된 네임스페이스의 메뉴에서 openshift-operators-redhat을 선택합니다.

    참고

    Elasticsearch 설치에는 Elasticsearch Operator의 openshift-operators-redhat 네임스페이스가 필요합니다. 다른 OpenShift Jaeger Operator는 openshift-operators 네임스페이스에 설치됩니다.

  8. OpenShift Container Platform 설치와 일치하는 업데이트 채널을 선택합니다. 예를 들어 OpenShift Container Platform 버전 4.6에 설치하는 경우 4.6 업데이트 채널을 선택합니다.
  9. 자동 승인 전략을 선택합니다.

    참고

    수동 승인 전략을 사용하려면 적절한 인증 정보를 가진 사용자가 Operator 설치 및 서브스크립션 프로세스를 승인해야 합니다.

  10. 설치를 클릭합니다.
  11. 설치된 Operator 페이지에서 openshift-operators-redhat 프로젝트를 선택합니다. 계속하기 전에 Elasticsearch Operator에 "InstallSucceeded" 상태가 표시될 때까지 기다립니다.

3.1.4. Jaeger Operator 설치

Jaeger를 설치하려면 OperatorHub를 사용하여 Jaeger Operator를 설치합니다.

기본적으로 Operator는 openshift-operators 프로젝트에 설치됩니다.

사전 요구 사항

  • OpenShift Container Platform 웹 콘솔에 액세스합니다.
  • cluster-admin 역할이 있는 계정.
  • 영구 스토리지가 필요한 경우 Jaeger Operator를 설치하기 전에 Elasticsearch Operator도 설치해야 합니다.
주의

Operator의 커뮤니티 버전은 설치하지 마십시오. 커뮤니티 Operator는 지원되지 않습니다.

프로세스

  1. cluster-admin 역할의 사용자로 OpenShift Container Platform 웹 콘솔에 로그인합니다.
  2. OperatorsOperatorHub로 이동합니다.
  3. Jaeger를 필터에 입력하여 Jaeger Operator를 찾습니다.
  4. Red Hat에서 제공하는 Jaeger Operator를 클릭하여 Operator에 대한 정보를 표시합니다.
  5. 설치를 클릭합니다.
  6. Operator 설치 페이지에서 stable 업데이트 채널을 선택합니다. 새로운 버전이 릴리스되면 Jaeger가 자동으로 업데이트됩니다. 유지 관리 채널(예: 1.17-stable)을 선택하면 해당 버전의 지원 주기 길이에 대한 버그 수정 및 보안 패치가 제공됩니다.
  7. 클러스터의 모든 네임스페이스(기본값)를 선택합니다. 이렇게 하면 기본 openshift-operators 프로젝트에서 Operator가 설치되고 클러스터의 모든 프로젝트에서 Operator를 사용할 수 있습니다.

    • 승인 전략을 선택합니다. 자동 또는 수동 업데이트를 선택할 수 있습니다. 설치된 Operator에 대해 자동 업데이트를 선택하는 경우 해당 Operator의 새 버전이 사용 가능하면 OLM(Operator Lifecycle Manager)은 개입 없이 Operator의 실행 중인 인스턴스를 자동으로 업그레이드합니다. 수동 업데이트를 선택하면 최신 버전의 Operator가 사용 가능할 때 OLM이 업데이트 요청을 작성합니다. 클러스터 관리자는 Operator를 새 버전으로 업데이트하려면 OLM 업데이트 요청을 수동으로 승인해야 합니다.

      참고

      수동 승인 전략을 사용하려면 적절한 인증 정보를 가진 사용자가 Operator 설치 및 서브스크립션 프로세스를 승인해야 합니다.

  8. 설치를 클릭합니다.
  9. 서브스크립션 개요 페이지에서 openshift-operators 프로젝트를 선택합니다. 계속하기 전에 Jaeger Operator에 "InstallSucceeded" 상태가 표시될 때까지 기다립니다.