스크립트를 사용하여 IBM Cloud Kubernetes Cluster에 MobileFirst Server 설정

bmx-kubernetes 폴더

IBM Cloud Container Service를 사용하여 Kubernetes Cluster에 배치하는 데 필요한 사용자 정의 파일 및 스크립트가 들어 있습니다.

Dockerfile-mfpf-analytics 및 Dockerfile-mfpf-server

• Dockerfile-mfpf-server: MobileFirst Server 이미지를 빌드하는 데 필요한 모든 명령을 포함하는 텍스트 문서입니다.
• Dockerfile-mfpf-analytics: MobileFirst Analytics 이미지를 빌드하는 데 필요한 모든 명령을 포함하는 텍스트 문서입니다.
• scripts 폴더: 이 폴더에는 구성 파일 세트가 포함된 args 폴더가 들어 있습니다. 또한 IBM Cloud에 로그인하고 MobileFirst Server/MobileFirst Analytics 이미지를 빌드하며 IBM Cloud에서 이미지를 푸시하고 실행하는 데 필요한 스크립트가 들어 있습니다. 스크립트를 대화식으로 실행하거나 구성 파일을 현상태대로 사전 구성하여 실행할 수 있습니다(나중에 자세히 설명함). 사용자 정의할 수 있는 args/*.properties 파일 외에는 이 폴더의 요소를 수정하지 마십시오. 스크립트 사용법 도움말을 보려면 -h 또는 --help 명령행 인수를 사용하십시오(예: scriptname.sh --help).
• usr-mfpf-server 및 usr-mfpf-analytics 폴더:
  • bin 폴더: 컨테이너 시작 시 실행되는 스크립트 파일(mfp-init)이 들어 있습니다. 사용자 고유의 사용자 정의 코드를 추가하여 실행할 수 있습니다.
  • config 폴더: MobileFirst Server/MobileFirst Analytics에서 사용되는 서버 구성 단편(키 저장소, 서버 특성, 사용자 레지스트리)이 들어 있습니다.
  • keystore.xml - SSL 암호화에 사용되는 보안 인증서 저장소의 구성입니다. 나열된 파일을 ./usr/security 폴더에서 참조해야 합니다.
  • ltpa.xml - LTPA 키와 비밀번호를 정의하는 구성 파일입니다.
  • mfpfproperties.xml - MobileFirst Server와 MobileFirst Analytics의 구성 특성입니다. 다음 문서 주제에 나열된 지원되는 특성을 참조하십시오.
    • MobileFirst Server 관리 서비스의 JNDI 특성 목록
    • MobileFirst 런타임의 JNDI 특성 목록
  • mfpfsqldb.xml - DB2 또는 dashDB 데이터베이스에 연결하는 JDBC Data 소스 정의입니다.
  • registry.xml - 사용자 레지스트리 구성입니다. basicRegistry(기본 XML 기반 사용자 레지스트리) 구성이 기본값으로 제공됩니다. basicRegistry에 사용할 사용자 이름과 비밀번호를 구성하거나 ldapRegistry를 구성할 수 있습니다.
  • tracespec.xml - 디버깅 및 로깅 레벨을 사용으로 설정하는 추적 스펙입니다.
• jre-security 폴더: JRE 보안 관련 파일(신뢰 저장소, 정책 JAR 파일 등)을 이 폴더에 저장하여 해당 파일을 업데이트할 수 있습니다. 이 폴더의 파일은 컨테이너의 JAVA_HOME/jre/lib/security/ 폴더에 복사됩니다.
• security 폴더: 키 저장소, 신뢰 저장소, LTPA 키 파일(ltpa.keys)을 저장하는 데 사용됩니다.
• env 폴더: 서버 초기화에 사용되는 환경 특성(server.env)과 사용자 정의 JVM 옵션(jvm.options)이 들어 있습니다.



클릭하면 지원되는 서버 환경 특성의 목록이 표시됩니다.

특성	기본값	설명
MFPF_SERVER_HTTPPORT	9080*	클라이언트 HTTP 요청에 사용되는 포트입니다. 이 포트를 사용하지 않으려면 -1을 사용하십시오.
MFPF_SERVER_HTTPSPORT	9443*	SSL(HTTPS)로 보안 설정된 클라이언트 HTTP 요청에 사용되는 포트입니다. 이 포트를 사용하지 않으려면 -1을 사용하십시오.
MFPF_ADMIN_ROOT	mfpadmin	MobileFirst Server 관리 서비스를 사용할 수 있는 컨텍스트 루트입니다.
MFPF_CONSOLE_ROOT	mfpconsole	MobileFirst Operations Console을 사용할 수 있는 컨텍스트 루트입니다.
MFPF_ADMIN_GROUP	mfpadmingroup	사전 정의된 역할 mfpadmin이 지정된 사용자 그룹의 이름입니다.
MFPF_DEPLOYER_GROUP	mfpdeployergroup	사전 정의된 역할 mfpdeployer가 지정된 사용자 그룹의 이름입니다.
MFPF_MONITOR_GROUP	mfpmonitorgroup	사전 정의된 역할 mfpmonitor가 지정된 사용자 그룹의 이름입니다.
MFPF_OPERATOR_GROUP	mfpoperatorgroup	사전 정의된 역할 mfpoperator가 지정된 사용자 그룹의 이름입니다.
MFPF_SERVER_ADMIN_USER	WorklightRESTUser	MobileFirst Server 관리 서비스의 Liberty 서버 관리자입니다.
MFPF_SERVER_ADMIN_PASSWORD	mfpadmin. 프로덕션 환경에 배치하기 전에 기본값을 개인용 비밀번호로 변경하십시오.	MobileFirst Server 관리 서비스의 Liberty 서버 관리자 비밀번호입니다.


섹션 닫기

클릭하면 지원되는 분석 환경 특성의 목록이 표시됩니다.

특성	기본값	설명
ANALYTICS_SERVER_HTTP PORT	9080*	클라이언트 HTTP 요청에 사용되는 포트입니다. 이 포트를 사용하지 않으려면 -1을 사용하십시오.
ANALYTICS_SERVER_HTTPS PORT	9443*	클라이언트 HTTP 요청에 사용되는 포트입니다. 이 포트를 사용하지 않으려면 -1을 사용하십시오.
ANALYTICS_ADMIN_GROUP	analyticsadmingroup	사전 정의된 역할 worklightadmin을 소유하는 사용자 그룹의 이름입니다.


섹션 닫기
• dependencies 폴더: Mobile Foundation 런타임과 IBM Java JRE 8을 포함합니다.
• mfpf-libs folder 폴더: MobileFirst 제품 컴포넌트 라이브러리와 CLI를 포함합니다.

섹션 닫기

args 폴더에는 스크립트를 실행하는 데 필요한 인수가 포함된 구성 파일 세트가 들어 있습니다. 다음 파일의 인수 값을 채우십시오.

initenv.properties

• IBM_CLOUD_API_URL - 배치하려는 지역 또는 영역입니다.
  

  예: api.ng.bluemix.net(미국), api.eu-de.bluemix.net(독일), api.au-syd.bluemix.net(시드니)

• IBM_CLOUD_ACCOUNT_ID - 영숫자 값으로 된 사용자의 계정 ID입니다(예: a1b1b111d11e1a11d1fa1cc999999999).
  계정 ID를 가져오려면 bx target 명령을 사용하십시오.
• IBM_CLOUD_USER - IBM Cloud 사용자 이름(이메일)입니다.
• IBM_CLOUD_PASSWORD - IBM Cloud 비밀번호입니다.
• IBM_CLOUD_ORG - IBM Cloud 조직 이름입니다.
• IBM_CLOUD_SPACE - IBM Cloud 영역(앞서 설명함)입니다.

prepareserverdbs.properties

Mobile Foundation 서비스에는 외부 DB2 on Cloud 인스턴스가 필요합니다.

참고: 사용자 고유의 DB2 데이터베이스도 사용할 수 있습니다. 데이터베이스에 연결하도록 IBM Cloud Kubenetes Cluster를 구성해야 합니다.

DB2 인스턴스를 설정한 후 다음과 같은 필수 인수를 제공하십시오.

• DB_TYPE - dashDB(DB2 on Cloud를 사용하는 경우) 또는 DB2(사용자 고유의 DB2 데이터베이스를 사용하는 경우)입니다.
• 사용자 고유의 DB2 데이터베이스(예: DB_TYPE=DB2)를 사용 중인 경우 다음 항목을 제공하십시오.
  • DB2_HOST - DB2 설정의 호스트 이름입니다.
  • DB2_DATABASE - 데이터베이스의 이름입니다.
  • DB2_PORT - 데이터베이스에 연결하는 포트입니다.
  • DB2_USERNAME - 데이터베이스 사용자(제공된 스키마 내의 테이블을 작성할 수 있는 권한이 있어야 하는 사용자 또는 스키마를 작성할 수 있어야 하는 사용자(스키마가 아직 존재하지 않는 경우))입니다.
  • DB2_PASSWORD - DB2 사용자의 비밀번호입니다.
• DB2 on Cloud(예: DB_TYPE=dashDB)를 사용 중인 경우 다음 항목을 제공하십시오.
  • ADMIN_DB_SRV_NAME - 관리 데이터를 저장하는 데 사용할 dashDB 서비스 인스턴스 이름입니다.
  • RUNTIME_DB_SRV_NAME - 런타임 데이터를 저장하는 데 사용할 dashDB 서비스 인스턴스 이름입니다. 기본값은 관리 서비스 이름입니다.
  • PUSH_DB_SRV_NAME - 런타임 데이터를 저장하는 데 사용할 dashDB 서비스 인스턴스 이름입니다. 기본값은 관리 서비스 이름입니다.
• ADMIN_SCHEMA_NAME - 관리 데이터의 스키마 이름입니다. 기본값은 MFPDATA입니다.
• RUNTIME_SCHEMA_NAME - 런타임 데이터의 스키마 이름입니다. 기본값은 MFPDATA입니다.
• PUSH_SCHEMA_NAME - 런타임 데이터의 스키마 이름입니다. 기본값은 MFPDATA입니다.

참고: 여러 사용자 또는 다중 Mobile Foundation 배치에서 DB2 데이터베이스 서비스 인스턴스를 공유 중인 경우 고유 스키마 이름을 제공하십시오.

prepareserver.properties

• SERVER_IMAGE_TAG - 이미지에 대한 태그입니다. registry-url/namespace/image:tag 양식이어야 합니다.
• ANALYTICS_IMAGE_TAG - 이미지에 대한 태그입니다. registry-url/namespace/image:tag 양식이어야 합니다.

예: registry.ng.bluemix.net/myuniquenamespace/mymfpserver:v1
아직 Docker 레지스트리 네임스페이스를 작성하지 않은 경우 다음 명령 중 하나를 사용하여 레지스트리 네임스페이스를 작성하십시오.


• bx cr namespace-add myuniquenamespace
• bx cr namespace-list

다음 지시사항은 구성 파일을 사용하여 스크립트를 실행하는 방법을 보여줍니다. 대화식 모드에서 선택해야 하는 명령행 인수의 목록도 사용 가능합니다.

1. initenv.sh – IBM Cloud에 로그인
   IBM Containers에서 Mobile Foundation을 빌드하고 실행하는 데 필요한 환경을 작성하려면 initenv.sh 스크립트를 실행하십시오. Interactive Mode

   ./initenv.sh

   Non-interactive Mode

   ./initenv.sh args/initenv.properties

2. prepareserverdbs.sh - MobileFirst Server 데이터베이스 준비
   prepareserverdbs.sh 스크립트는 DB2 데이터베이스 서비스를 사용해서 MobileFirst Server를 구성하는 데 사용됩니다. 1단계에서 로그인한 조직과 영역에서 DB2 서비스의 서비스 인스턴스를 사용할 수 있어야 합니다. 다음을 실행하십시오. Interactive Mode

   ./prepareserverdbs.sh

   Non-interactive Mode

   ./prepareserverdbs.sh args/prepareserverdbs.properties

3. initenv.sh(선택사항) – IBM Cloud에 로그인
   이 단계는 DB2 서비스 인스턴스를 사용할 수 있는 조직과 영역 이외의 조직과 영역에서 컨테이너를 작성해야 하는 경우에만 필수입니다. 값이 예인 경우에는 컨테이너가 작성되고 시작되어야 하는 새 조직과 영역으로 initenv.properties를 업데이트하고 initenv.sh 스크립트를 다시 실행하십시오.

   ./initenv.sh args/initenv.properties

4. prepareserver.sh - MobileFirst Server 이미지 준비
   MobileFirst Server 및 MobileFirst Analytics 이미지를 빌드하여 IBM Cloud 저장소에 푸시하려면 prepareserver.sh 스크립트를 실행하십시오. IBM Cloud 저장소에서 사용할 수 있는 모든 이미지를 보려면 bx cr image-list를 실행하십시오.
   목록은 이미지 이름, 작성 날짜, ID를 포함합니다.
   Interactive Mode

   ./prepareserver.sh

   Non-interactive Mode

   ./prepareserver.sh args/prepareserver.properties

5. IBM Cloud Container Service를 사용하여 Kubernetes 클러스터의 Docker 컨테이너에 MobileFirst Server 및 MobileFirst Analytics를 배치하십시오.
   1. 터미널 컨텍스트를 클러스터에 설정하십시오.
      bx cs cluster-config my-cluster
      클러스터 이름을 확인하려면 다음 명령을 실행하십시오.
      bx cs clusters
      출력에서 구성 파일에 대한 경로가 환경 변수를 설정하는 명령으로 표시됩니다. 예를 들면, 다음과 같습니다.
      export KUBECONFIG=/Users/ibm/.bluemix/plugins/container-service/clusters/my-cluster/kube-config-prod-dal12-my-cluster.yml
      my-cluster를 클러스터 이름으로 대체한 후 위의 명령을 복사하고 붙여넣어 터미널에서 환경 변수를 설정하고 Enter를 누르십시오.
   2. [MobileFirst Analytics의 경우 필수]: 지속적 볼륨 클레임을 작성하십시오. 이는 지속적 분석 데이터에 사용됩니다. 일회성 단계입니다. 이전에 이미 작성한 경우 PVC를 재사용할 수 있습니다. yaml 파일 args/mfpf-persistent-volume-claim.yaml을 편집한 후 명령을 실행하십시오. 다음 kubectl 명령을 실행하기 전에 모든 변수가 해당 값으로 대체되어야 합니다.
      kubectl create -f ./args/mfpf-persistent-volume-claim.yaml
      후속 단계에서 제공해야 하므로 지속적 볼륨 클레임의 이름을 기록해 두십시오.
   3. 수신 도메인을 가져오려면 다음 명령을 실행하십시오.
      bx cs cluster-get my-cluster
      수신 도메인을 기록해 두십시오. TLS를 구성해야 하는 경우 수신 시크릿을 기록해 두십시오.
   4. Kubernetes 배치를 작성하십시오.
      yaml 파일인 args/mfpf-deployment-all.yaml을 편집하고 세부사항을 채우십시오. kubectl 명령을 실행하기 전에 모든 변수가 해당 값으로 대체되어야 합니다.
      ./args/mfpf-deployment-all.yaml에는 다음 항목에 대한 배치가 포함됩니다.
      • MobileFirst Server의 Kubernetes 배치: 세 개의 인스턴스(복제본), 1024MB 메모리 및 1Core CPU로 구성.
      • MobileFirst Analytics의 Kubernetes 배치: 두 개의 인스턴스(복제본), 1024MB 메모리 및 1Core CPU로 구성.
      • MobileFirst Server의 Kubernetes 서비스.
      • MobileFirst Analytics의 Kubernetes 서비스.
      • MobileFirst Server 및 MobileFirst Analytics에 대한 모든 REST 엔드포인트를 포함하는 전체 설정에 대한 수신(ingress).
      • MobileFirst Server 및 MobileFirst Analytics 인스턴스에서 환경 변수를 사용할 수 있도록 하는 configMap.
      YAML 파일에서 다음 값을 편집해야 합니다.
      
      1. 위에 설명된 대로 bx cs cluster-get 명령의 출력과는 다른 my-cluster.us-south.containers.mybluemix.net의 발생(수신 도메인의 출력 사용)
      2. registry.ng.bluemix.net/repository/mfpfanalytics:latest 및 registry.ng.bluemix.net/repository/mfpfserver:latest - 이미지를 업로드하기 위해 prepareserver.sh에서 사용한 동일한 이름을 사용하십시오.
      3. claimName: mfppvc - PVC를 작성하기 위해 위에서 사용한 대로 동일한 지속적 볼륨 클레임 이름을 사용하십시오.
         
      다음 명령을 실행하십시오.
      kubectl create -f ./args/mfpf-deployment-all.yaml

      참고:
      다음 템플리트 yaml 파일이 제공됩니다.
      

      • mfpf-deployment-all.yaml: http를 사용하여 MobileFirst Server 및 MobileFirst Analytics를 배치합니다.
      • mfpf-deployment-all-tls.yaml: http를 사용하여 MobileFirst Server 및 MobileFirst Analytics를 배치합니다.
      • mfpf-deployment-server.yaml: http를 사용하여 MobileFirst Server를 배치합니다.
      • mfpf-deployment-analytics.yaml: http를 사용하여 MobileFirst Analytics를 배치합니다.

      작성 후 Kubernetes 대시보드를 사용하려면 다음 명령을 실행하십시오.
      kubectl proxy
      브라우저에서 localhost:8001/ui를 여십시오.