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

bmx-kubernetes 폴더

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

Dockerfile-mfp-appcenter

• Dockerfile-mfp-appcenter: MobileFirst Application Center 이미지를 빌드하기 위해 필요한 모든 명령이 포함된 텍스트 문서입니다.
• scripts 폴더: 이 폴더에는 구성 파일 세트가 포함된 args 폴더가 들어 있습니다. 이 폴더에는 IBM Cloud에 로그인하여 MobileFirst Application Center 이미지를 빌드하고 IBM Cloud에서 이미지를 푸시 및 실행하기 위해 필요한 스크립트도 포함되어 있습니다. 스크립트를 대화식으로 실행하거나 구성 파일을 현상태대로 사전 구성하여 실행할 수 있습니다(나중에 자세히 설명함). 사용자 정의할 수 있는 args/*.properties 파일 외에는 이 폴더의 요소를 수정하지 마십시오. 스크립트 사용법 도움말을 보려면 -h 또는 --help 명령행 인수를 사용하십시오(예: scriptname.sh --help).
• usr-mfp-appcenter 폴더:
  • bin 폴더: 컨테이너가 시작될 때 실행되는 스크립트 파일(mfp-appcenter-init)이 포함되어 있습니다. 사용자 고유의 사용자 정의 코드를 추가하여 실행할 수 있습니다.
  • config 폴더: MobileFirst Application Center에서 사용되는 서버 구성 단편(키 저장소, 서버 특성, 사용자 레지스트리)이 들어 있습니다.
  • keystore.xml - SSL 암호화에 사용되는 보안 인증서 저장소의 구성입니다. 나열된 파일을 ./usr/security 폴더에서 참조해야 합니다.
  • ltpa.xml - LTPA 키와 비밀번호를 정의하는 구성 파일입니다.
  • appcentersqldb.xml - DB2 또는 dashDB 데이터베이스에 연결할 JDBC 데이터 소스 정의입니다.
  • 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)이 들어 있습니다.



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

특성	기본값	설명
APPCENTER_SERVER_HTTPPORT	9080*	클라이언트 HTTP 요청에 사용되는 포트입니다. 이 포트를 사용하지 않으려면 -1을 사용하십시오.
APPCENTER_SERVER_HTTPSPORT	9443*	SSL(HTTPS)로 보안 설정된 클라이언트 HTTP 요청에 사용되는 포트입니다. 이 포트를 사용하지 않으려면 -1을 사용하십시오.
APPCENTER_ROOT	applicationcenter	MobileFirst Application Center 관리 서비스를 사용할 수 있는 컨텍스트 루트입니다.
APPCENTER_CONSOLE_ROOT	appcenterconsole	MobileFirst Application Center 콘솔을 사용할 수 있는 컨텍스트 루트입니다.
APPCENTER_ADMIN_GROUP	appcenteradmingroup	사전 정의된 역할 appcenteradmin이 지정된 사용자 그룹의 이름입니다.
APPCENTER_USER_GROUP	appcenterusergroup	사전 정의된 역할 appcenteruser가 지정된 사용자 그룹의 이름입니다.


섹션 닫기
• 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 영역(앞서 설명함)입니다.

prepareappcenterdbs.properties

MobileFirst Application Center를 사용하려면 외부 DB2 on Cloud 인스턴스가 필요합니다.

참고: 사용자 고유의 DB2 데이터베이스도 사용할 수 있습니다. 데이터베이스에 연결하도록 IBM Cloud Kubernetes 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)를 사용 중인 경우 다음 항목을 제공하십시오.
  • APPCENTER_DB_SRV_NAME - appcenter 데이터를 저장하기 위해 필요한 dashDB 서비스 인스턴스 이름입니다.
• APPCENTER_SCHEMA_NAME - appcenter 데이터의 스키마 이름입니다. 기본값은 APPCNTR입니다.

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

prepareappcenter.properties

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

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


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

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

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

   ./initenv.sh

   Non-interactive Mode

   ./initenv.sh args/initenv.properties

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

   ./prepareappcenterdbs.sh

   Non-interactive Mode

   ./prepareappcenterdbs.sh args/prepareappcenterdbs.properties

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

   ./initenv.sh args/initenv.properties

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

   ./prepareappcenter.sh

   Non-interactive Mode

   ./prepareappcenter.sh args/prepareappcenter.properties

5. IBM Cloud Container Service를 사용하여 Kubernetes 클러스터의 Docker 컨테이너에 MobileFirst Application Center를 배치하십시오.
   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. 수신 도메인을 가져오려면 다음 명령을 실행하십시오.
      bx cs cluster-get my-cluster
      수신 도메인을 기록해 두십시오. TLS를 구성해야 하는 경우 수신 시크릿을 기록해 두십시오.
   3. Kubernetes 배치를 작성하십시오.
      yaml 파일 args/mfp-deployment-appcenter.yaml을 편집하고 세부사항을 기입하십시오. kubectl 명령을 실행하기 전에 모든 변수가 해당 값으로 대체되어야 합니다.
      ./args/mfp-deployment-appcenter.yaml에는 다음 항목에 대한 배치가 포함됩니다.
      • MobileFirst Application Center의 Kubernetes 배치: 하나의 인스턴스(복제본), 1024MB 메모리 및 1Core CPU로 구성.
      • MobileFirst Application Center의 Kubernetes 서비스.
      • MobileFirst Application Center에 대한 모든 REST 엔드포인트를 포함하는 전체 설정에 대한 수신(ingress).
      • MobileFirst Application Center 인스턴스에서 환경 변수를 사용할 수 있도록 하는 configMap.
      YAML 파일에서 다음 값을 편집해야 합니다.
      
      1. 위에 설명된 대로 bx cs cluster-get 명령의 출력과는 다른 my-cluster.us-south.containers.mybluemix.net의 발생(수신 도메인의 출력 사용)
      2. registry.ng.bluemix.net/repository/mfpappcenter:latest - 이미지를 업로드하기 위해 prepareappcenter.sh에서 사용한 동일한 이름을 사용하십시오.
      다음 명령을 실행하십시오.
      kubectl create -f ./args/mfp-deployment-appcenter.yaml

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

      • mfp-deployment-appcenter.yaml: HTTP를 사용하여 MobileFirst Application Center를 배치합니다.
      • mfp-deployment-appcenter-with-tls.yaml: HTTPS를 사용하여 MobileFirst Application Center를 배치합니다.

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