IBM Cloud Private에서 MobileFirst Server 설정

improve this page | report issue

개요

IBM Cloud Private에서 MobileFirst Server 인스턴스 및 MobileFirst Analytics 인스턴스를 구성하려면 아래의 지시사항을 수행하십시오.

  • IBM Cloud Private Kubernetes Cluster를 설정하십시오.
  • 필수 도구(Docker, IBM Cloud CLI( bx ), IBM Cloud Private(icp) IBM Cloud CLI를 위한 플러그인(bx pr), Kubernetes CLI(kubectl)) 및 Helm CLI(helm))를 사용하여 호스트 컴퓨터를 설정하십시오.
  • IBM Cloud Private용 IBM Mobile Foundation의 Passport Advantage 아카이브(PPA 아카이브)를 다운로드하십시오.
  • IBM Cloud Private 클러스터의 PPA 아카이브를 로드하십시오.
  • 마지막으로 MobileFirst Analytics(선택사항) 및 MobileFirst Server를 구성 및 설치하십시오.

다음으로 이동:

전제조건

IBM Cloud Private 계정이 있어야 하며 IBM Cloud Private 클러스터 설치의 문서에 따라 Kubernetes Cluster를 설정해야 합니다..

컨테이너 및 이미지를 관리하려면 IBM Cloud Private 설치의 일부로 호스트 시스템에 다음 도구를 설치해야 합니다.

  • Docker
  • IBM Cloud CLI(bx)
  • IBM Cloud Private(ICP) IBM Cloud CLI를 위한 플러그인( bx pr )
  • Kubernetes CLI(kubectl)
  • Helm(helm)

CLI를 사용하여 IBM Cloud Private 클러스터에 액세스하려면 kubectl 클라이언트를 구성해야 합니다. 자세히 알아보기.

IBM Mobile Foundation Passport Advantage 아카이브 다운로드

IBM Mobile Foundation의 Passport Advantage(PPA) 아카이브는 여기에서 사용할 수 있습니다. Mobile Foundation의 PPA 아카이브에는 다음 Mobile Foundation 컴포넌트의 Docker 이미지 및 Helm Charts가 포함됩니다.

  • MobileFirst Server
  • MobileFirst Analytics
  • MobileFirst Application Center

IBM Mobile Foundation Passport Advantage 아카이브 로드

Mobile Foundation의 PPA 아카이브를 로그하기 전에 Docker를 설치해야 합니다. 여기에서 지시사항을 확인하십시오.

PPA 아카이브를 IBM Cloud Private 클러스터에 로드하려면 아래에 제공된 단계를 따르십시오.

  1. IBM Cloud ICP 플러그인(bx pr)을 사용하여 클러스터에 로그인하십시오.

    IBM Cloud Private 문서의 CLI 명령 참조서를 확인하십시오.

    예를 들어, 다음과 같습니다.

     bx pr login -a https://ip:port
    
       선택적으로 SSL 유효성 검증을 건너뛰려면 위의 명령에서 `--skip-ssl-validation` 플래그를 사용하십시오. 이 옵션을 사용하면 클러스터 엔드포인트의 `username` 및 `password`에 대한 프롬프트가 표시됩니다. 로그인이 성공하면 아래의 단계를 진행하십시오.
    
  2. 다음 명령을 사용하여 Mobile Foundation의 PPA 아카이브를 로드하십시오.
     bx pr load-ppa-archive --archive <archive_name> [--clustername <cluster_name>] [--namespace <namespace>]
    

    Mobile Foundation의 archive_name은 IBM Passport Advantage에서 다운로드한 PPA 아카이브의 이름입니다.

    이전 단계를 수행하고 bx pr의 기본값으로 클러스터 엔드포인트를 작성한 경우 --clustername은 무시할 수 있습니다.

  3. PPA 아카이브를 로드한 후 저장소를 동기화하면 카탈로그의 Helm Charts 목록이 표시됩니다. IBM Cloud Private 관리 콘솔에서 이 작업을 완료할 수 있습니다.
    • 관리 > 저장소를 선택하십시오.
    • 저장소 동기화를 클릭하십시오.
  4. IBM Cloud Private 관리 콘솔에서 Docker 이미지 및 Helm Charts를 보십시오. Docker 이미지를 보려면 다음과 같이 하십시오.
    • 플랫폼 > 이미지를 선택하십시오.
    • Helm Charts가 카탈로그에 표시됩니다.

위의 단계를 완료하면 Helm Charts의 업로드된 버전이 ICP 카탈로그에 표시됩니다. MobileFirst Server는 ibm-mfpf-server-prod로 나열되고 MobileFirst Analytics는 ibm-mfpf-analytics-prod로 나열됩니다.

IBM Mobile Foundation Helm Charts 설치 및 구성

MobileFirst Server를 설치 및 구성하기 전에 다음이 있어야 합니다.

  • [필수] 구성되어 사용할 준비가 된 DB2 데이터베이스. MobileFirst Server helm을 구성하려면 데이터베이스 정보가 필요합니다. MobileFirst Server에는 스키마 및 테이블이 필요하며 없는 경우 이 데이터베이스에 작성됩니다.

  • [선택사항] 키 저장소 및 신뢰 저장소가 있는 시크릿. 자체 키 저장소 및 신뢰 저장소가 있는 시크릿을 작성하여 자체 키 저장소 및 신뢰 저장소를 배치에 제공할 수 있습니다.

    설치 전에 아래의 단계를 따르십시오.

    • keystore.jks, keystore-password.txt, truststore.jks, truststore-password.txt로 시크릿을 작성하고 keystores.keystoresSecretName 필드에 시크릿 이름을 제공하십시오.

    • keystore-password.txttruststore.jks 파일에 keystore.jks 및 해당 비밀번호를 보관하고 truststore-password.jks 파일에 해당 비밀번호를 보관하십시오.

    • 명령행으로 이동하여 다음을 실행하십시오.
      kubectl create secret generic mfpf-cert-secret --from-file keystore-password.txt --from-file truststore-password.txt --from-file keystore.jks --from-file truststore.jks
      

      참고: 파일 이름은 언급한 것과 동일해야 합니다. 예를 들어, keystore.jks, keystore-password.txt, truststore.jkstruststore-password.txt입니다.

    • 기본 키 저장소를 대체하려면 keystoresSecretName의 시크릿 이름을 제공하십시오.

    자세한 정보는 MobileFirst Server 키 저장소 구성을 참조하십시오.

MobileFirst Analytics에 대한 환경 변수

아래의 표에서는 IBM Cloud Private의 MobileFirst Analytics에서 사용되는 환경 변수를 제공합니다.

규정자 매개변수 정의 허용값
arch   작업자 노드 아키텍처 이 차트를 배치해야 하는 작업자 노드 아키텍처.
AMD64 플랫폼만 현재 지원됩니다.
image pullPolicy 이미지 가져오기 정책 기본값은 IfNotPresent입니다.
  tag Docker 이미지 태그 Docker 태그 설명을 참조하십시오.
  name Docker 이미지 이름 Operational Analytics Docker 이미지의 이름.
scaling replicaCount 작성해야 하는 Operational Analytics의 인스턴스(포드) 수 양의 정수
기본값은 2입니다.
mobileFirstAnalyticsConsole user Operational Analytics의 사용자 이름 기본값은 admin입니다.
  password Operational Analytics의 비밀번호 기본값은 admin입니다.
analyticsConfiguration clusterName Analytics 클러스터의 이름 기본값은 mobilefirst입니다.
  analyticsDataDirectory 분석 데이터가 저장된 경로. 또한 지속적 볼륨 클레임이 컨테이너 내부에 마운트된 경로와 동일합니다. 기본값은 /analyticsData입니다.
  numberOfShards Analytics에 대한 Elasticsearch 샤드 수 양의 정수
기본값은 2입니다.
  replicasPerShard Analytics에 대해 각 샤드별로 유지보수할 Elasticsearch 복제본 수 양의 정수
기본값은 2입니다.
keystores keystoresSecretName 키 저장소 및 해당 비밀번호가 있는 시크릿 작성 단계를 설명하는 IBM Mobile Foundation Helm Charts 설치 및 구성을 참조하십시오.  
jndiConfigurations mfpfProperties Operational Analytics 사용자 정의를 위해 지정할 JNDI 특성 쉼표로 구분된 이름 값 쌍을 제공하십시오.
resources limits.cpu 허용되는 최대 CPU 양 설명 기본값은 2000m입니다.
CPU의 의미를 읽으십시오.
  limits.memory 허용되는 최대 메모리 양 설명 기본값은 4096Mi입니다.
메모리의 의미를 읽으십시오.
  requests.cpu 필요한 최소 CPU 양 설명. 지정되지 않은 경우 기본값은 한계(지정된 경우)이거나 그렇지 않으면 구현 정의된 값입니다. 기본값은 1000m입니다.
  requests.memory 필요한 최소 메모리 양 설명. 지정되지 않은 경우 메모리 양의 기본값은 한계(지정된 경우)이거나 구현 정의된 값입니다. 기본값은 2048Mi입니다.
persistence existingClaimName 기존 지속성 볼륨 클레임(PVC)의 이름  

MobileFirst Server에 대한 환경 변수

아래의 표에서는 IBM Cloud Private의 MobileFirst Server에서 사용되는 환경 변수를 제공합니다.

규정자 매개변수 정의 허용값
arch   작업자 노드 아키텍처 이 차트를 배치해야 하는 작업자 노드 아키텍처.
AMD64 플랫폼만 현재 지원됩니다.
image pullPolicy 이미지 가져오기 정책 기본값은 IfNotPresent입니다.
  tag Docker 이미지 태그 Docker 태그 설명을 참조하십시오.
  name Docker 이미지 이름 Server Docker 이미지의 이름입니다.
scaling replicaCount 작성해야 하는 Server의 인스턴스(포드) 수 양의 정수
기본값은 3입니다.
mobileFirstOperationsConsole user Server의 사용자 이름 기본값은 admin입니다.
  password Server 사용자의 비밀번호 기본값은 admin입니다.
existingDB2Details db2Host Server 테이블을 구성해야 하는 DB2 데이터베이스의 IP 주소 또는 호스트 현재 DB2만 지원됩니다.
  db2Port DB2 데이터베이스가 설정된 포트  
  db2Database DB2에서 사용하기 위해 사전 구성된 데이터베이스의 이름  
  db2Username DB2 데이터베이스에 액세스할 DB2 사용자 이름 사용자에게 테이블을 작성하고 스키마를 작성할 수 있는 액세스 권한이 있어야 합니다(아직 없는 경우).
  db2Password 제공된 데이터베이스의 DB2 비밀번호  
  db2Schema 작성할 서버 DB2 스키마  
  db2ConnectionIsSSL DB2 연결 유형 데이터베이스 연결이 http여야 하는지 또는 https여야 하는지 지정하십시오. 기본값은 false(http)입니다.
또한 DB2 포트가 동일한 연결 모드로 구성되어 있는지 확인하십시오.
existingMobileFirstAnalytics analyticsEndPoint Analytics Server의 URL 예를 들어, http://9.9.9.9:30400입니다.
콘솔에 대한 경로를 지정하지 마십시오. 이 경로는 배치 중에 추가됩니다.
       
  analyticsAdminUser Analytics 관리자의 사용자 이름  
  analyticsAdminPassword Analytics 관리자의 비밀번호  
keystores keystoresSecretName 키 저장소 및 해당 비밀번호가 있는 시크릿 작성 단계를 설명하는 IBM Mobile Foundation Helm Charts 설치 및 구성을 참조하십시오.  
jndiConfigurations mfpfProperties 배치 사용자 정의를 위한 Server JNDI 특성 쉼표로 구분된 이름 값 쌍입니다.
resources limits.cpu 허용되는 최대 CPU 양 설명 기본값은 2000m입니다.
CPU의 의미를 읽으십시오.
  limits.memory 허용되는 최대 메모리 양 설명 기본값은 4096Mi입니다.
메모리의 의미를 읽으십시오.
  requests.cpu 필요한 최소 CPU 양 설명. 지정되지 않은 경우 이 기본값은 한계(지정된 경우)이거나 그렇지 않으면 구현 정의된 값입니다. 기본값은 1000m입니다.
  requests.memory 필요한 최소 메모리 양 설명. 지정되지 않은 경우 이 기본값은 한계(지정된 경우)이거나 구현 정의된 값입니다. 기본값은 2048Mi입니다.

ICP 카탈로그에서 Helm Charts 설치

MobileFirst Analytics 설치

MobileFirst Analytics 설치는 선택사항입니다. MobileFirst Server에서 Analytics를 사용으로 설정하려면 MobileFirst Server를 설치하기 전에 MobileFirst Analytics를 먼저 구성하고 설치해야 합니다.

MobileFirst Analytics Chart를 설치하기 전에 지속적 볼륨을 구성하십시오. MobileFirst Analytics를 구성하려면 지속적 볼륨을 제공하십시오. 지속적 볼륨을 작성하려면 IBM Cloud Private 문서에 자세히 설명된 단계를 따르십시오.

IBM Cloud Private 관리 콘솔에서 IBM MobileFirst Analytics를 설치 및 구성하려면 아래의 단계를 따르십시오.

  1. 관리 콘솔에서 카탈로그로 이동하십시오.
  2. ibm-mfpf-analytics-prod helm chart를 선택하십시오.
  3. 구성을 클릭하십시오.
  4. 환경 변수를 제공하십시오. 자세한 정보는 MobileFirst Analytics에 대한 환경 변수를 참조하십시오.
  5. 라이센스 계약에 동의하십시오.
  6. 설치를 클릭하십시오.

MobileFirst Server 설치

MobileFirst Server를 설치하기 전에 DB2 데이터베이스가 사전 구성되어 있는지 확인하십시오.

IBM Cloud Private 관리 콘솔에서 IBM MobileFirst Server를 설치 및 구성하려면 아래의 단계를 따르십시오.

  1. 관리 콘솔에서 카탈로그로 이동하십시오.
  2. ibm-mfpf-server-prod helm chart를 선택하십시오.
  3. 구성을 클릭하십시오.
  4. 환경 변수를 제공하십시오. 자세한 정보는 MobileFirst Server에 대한 환경 변수를 참조하십시오.
  5. 라이센스 계약에 동의하십시오.
  6. 설치를 클릭하십시오.

설치 확인

MobileFirst Analytics(선택사항) 및 MobileFirst Server를 설치 및 구성한 후 다음을 완료하여 설치 및 배치된 포드 상태를 확인할 수 있습니다.

IBM Cloud Private 관리 콘솔에서 워크로드 > Helm 릴리스를 선택하십시오. 설치의 릴리스 이름을 클릭하십시오.

콘솔 액세스

설치 완료 후 <protocol>://<ip_address>:<port>/mfpconsole을 사용하여 Operational Console에 액세스할 수 있습니다. IBM MobileFirst Analytics Console은 <protocol>://<ip_address>:<port>/analytics/console을 사용하여 액세스할 수 있습니다.

프로토콜은 http 또는 https일 수 있습니다. 또한 NodePort 배치의 경우 포트는 NodePort가 됩니다. 설치된 Chart의 ip_address 및 NodePort를 가져오려면 아래의 단계를 따르십시오.

  1. IBM Cloud Private 관리 콘솔에서 워크로드 > Helm 릴리스를 선택하십시오.
  2. helm chart 설치의 릴리스 이름을 클릭하십시오.
  3. 참고 섹션을 확인하십시오.

참고: 포트 9600은 Kubernetes 서비스에서 내부적으로 노출되며 Analytics 인스턴스가 전송 포트로 사용됩니다.

샘플 애플리케이션

샘플 어댑터를 배치하고 IBM Cloud Private에서 실행되는 IBM MobileFirst Server에 샘플 어댑터를 배치하고 샘플 애플리케이션을 실행하려면 학습서를 참조하십시오.

Helm Charts 및 릴리스 업그레이드

helm charts/릴리스 업그레이드 방법에 대한 지시사항은 번들 제품 업그레이드를 참조하십시오.

Helm 릴리스 업그레이드를 위한 샘플 시나리오

  1. values.yaml 값을 변경한 helm 릴리스를 업그레이드하려면 helm upgrade 명령을 –set 플래그와 함께 사용하십시오. –set 플래그를 여러 번 지정할 수 있습니다. 우선순위는 명령행에 지정된 가장 오른쪽 세트에 주어집니다.
      helm upgrade --set <name>=<value> --set <name>=<value> <existing-helm-release-name> <path of new helm chart>
    
  2. 파일에 값을 제공하여 helm 릴리스를 업그레이드하려면 helm upgrade 명령을 -f 플래그와 함께 사용하십시오. –values 또는 -f 플래그를 여러 번 사용할 수 있습니다. 우선순위는 명령행에 지정된 가장 오른쪽 파일에 주어집니다. 다음 예제에서 myvalues.yamloverride.yaml 모두에 테스트 키가 포함된 경우 override.yaml에 설정된 값이 우선순위입니다.
      helm upgrade -f myvalues.yaml -f override.yaml <existing-helm-release-name> <path of new helm chart>
    
  3. 마지막 릴리스의 값을 다시 사용하고 일부를 대체하여 helm 릴리스를 업그레이드하기 위해 아래와 같은 명령을 사용할 수 있습니다.
      helm upgrade --reuse-values --set <name>=<value> --set <name>=<value> <existing-helm-release-name> <path of new helm chart>
    

설치 제거

MobileFirst Server 및 MobileFirst Analytics를 설치 제거하려면 Helm CLI를 사용하십시오. 다음 명령을 사용하여 설치된 차트 및 연관된 배치를 완전히 삭제하십시오.

helm delete --purge <release_name>

release_name은 Helm Chart의 배치된 릴리스 이름입니다.

Last modified on July 17, 2018