LINUX 플랫폼용

배치 REST API를 사용하여 Node.js 서버 배치

DeployService REST API를 사용하여 집합체의 멤버로서 Node.js 애플리케이션을 배치할 수 있습니다. Node.js 집합체 멤버는 이 문서에서 Node.js server라고 합니다.

시작하기 전에

Node.js 서버를 설치하려는 대상 호스트를 판별하십시오. 대상 호스트의 Install Node.js V4 및 apiconnect-collective-member npm 패키지. Node.js 서버를 위한 지원을 Linux에 설치하기 위한 명령은 다음과 같습니다.

npm install -g apiconnect-collective-member

각 대상 호스트에는 RXA 또는 SSH가 필요합니다. Liberty 집합체 조작에 대한 RXA 설정을 확인하십시오.

프로시저

  1. 제어기 server.xml 파일에서 집합적 제어기를 위한 사용자 이름 및 비밀번호를 설정하십시오. 예:
    <collectiveController user="admin" password="adminpwd" />
  2. Node.js 애플리케이션을 집합적 제어기에 추가하십시오.
    1. 설치하기 위한 Node.js 애플리케이션을 선택하십시오. 애플리케이션은 해당 종속성이 해결되도록 해야 합니다.
      .tgz 확장자를 가진 노드 애플리케이션 압축된 TAR 아카이브를 Liberty에 배치합니다. 애플리케이션에는 일반적으로 다음 디렉토리 구조가 있습니다.
      package/
            app.js
            package.json
            node_modules/.. 
            server.json
      • app.js는 애플리케이션입니다.
      • package.json은 Node.js npm에 의해 필요에 따라 애플리케이션을 위한 종속성을 가지고 있습니다.
      • node_modules/.. 디렉토리에서는 package.json에서 생성되는 애플리케이션에서 사용하는 포함이 제공됩니다.
      • server.json은 포트와 다른 설정을 구성하는 선택적 파일입니다.

      배치할 애플리케이션에 대한 자세한 정보는 apiconnect-collective-member wlpn-server 및 wlpn-collective 명령에서 pack 명령 설명을 참조하십시오.

    2. 집합적 제어기가 액세스할 수 있는 디렉토리에 Node.js 애플리케이션을 두십시오.
    3. 디렉토리를 가리키는 remoteFileAccess 명령문을 제어기 server.xml 파일에 추가하십시오. 예:
      <remoteFileAccess readDir="/tmp/nodejsApplications" />

      이 디렉토리는 5단계에서 deployService 배치를 위해 지정되는 applicationDir 입력 변수입니다. applicationDir 디렉토리는 제어기에 있습니다.

  3. 제어기 server.xml 파일이 제어기 사용자 이름과 비밀번호 및 배치 변수를 정의하는 명령문을 가지고 있는지 확인하십시오. 예:
       <collectiveController user="admin" password="adminpwd" />
    ... 
       <deployVariable name="appPort" value="9090" increment="1"/> 
       <deployVariable name="adminPort" value="9453" increment="1"/>

    배치 변수는 각 멤버가 대상 호스트에 고유한 포트 번호를 가지고 있을 수 있도록 하는 값을 설정해야 합니다. DeployVariable(deployVariable)을 확인하십시오.

  4. 집합적 제어기로 Node.js 서버를 설치하려는 호스트를 등록하십시오.

    호스트를 등록하는 것은 집합적 제어기가 호스트에 파일, 명령 및 다른 자원에 액세스할 수 있게 합니다. wlpn-collective registerHost 명령을 사용하여 대상 호스트를 등록하십시오. --host, --port, --user 및 --password 매개변수에 대한 값을 찾으려면 제어기의 server.xml 파일을 보십시오. Linux 또는 Windows 운영 체제의 대상 호스트의 경우와 같이 SSH 개인 키 파일을 사용하지 않으려면, --rpcUser 및 --rpcUserPassword 매개변수를 설정하여 운영 체제 로그인 사용자 및 비밀번호를 포함하십시오. --rpcUser에 지정된 사용자에게 대상 배치 위치에 대한 운영 체제 권한이 있어야 합니다.명령에 --autoAcceptCertificates가 포함되는지 확인하십시오.

    wlpn-collective registerHost targetHost --host=controllerHost --port=controllerHTTPSPort 
    --user=controllerAdmin --password=controllerAdminPassword --rpcUser=osUser --rpcUserPassword=osUserPassword --autoAcceptCertificates

    호스트가 이미 등록된 경우에는 updateHost 명령을 사용하여 등록 정보를 재설정할 수 있습니다. 자세한 정보는 apiconnect-collective-member wlpn-server 및 wlpn-collective 명령의 내용을 참조하십시오.

    구성원 서버를 배치하기 위해 나중에 사용할 사용자로서 wlpn-collective registerHost 또는 updateHost 명령을 실행하는지 확인하십시오. 예를 들어, root 사용자로서 명령을 실행시키고 더 다양한 사용자로서 멤버를 배치하면, DeployService가 /root/wlpn 디렉토리에 파일을 푸시하기 위한 권리를 가지고 있지 않기 때문에 배치에 실패합니다.

  5. 사용 가능한 배치 규칙을 검토하십시오.
    1. JSON 구조에서 사용 가능한 배치 규칙을 리턴하는 REST API를 호출하십시오.
      GET https://controller_host:controller_port/ibm/api/collective/v1/deployment/rule 

      호출은 JSON 구조에서 배치 규칙을 리턴합니다.

      {"rules":
      [
        {"id":"Node.js Server Rule","description":"Deploy rule for Liberty Node.js servers.","type":"Node.js" 
        ...
        }
      ]
      }
    2. 필요한 경우, 제어기 구성에 DeployRules를 추가하여 자체 배치 규칙을 작성하십시오. 배치 규칙(deployRule)을 확인하십시오.
  6. Node.js 서버를 배치하십시오.

    배치 규칙에는 사용할 Node.js 서버 및 작성할 컨테이너 이름 같이 조작을 위한 입력 값을 지정하는 데 사용할 수 있는 변수가 들어 있습니다. 리턴 본문에는 상태 및 결과를 요청하는 데 사용할 수 있는 토큰이 들어 있습니다.

    POST https://controller_host:controller_port/ibm/api/collective/v1/deployment/deploy
    
    {
       "rule":"Node.js Server Rule",
       "hosts":["localhost"],
       "variables": [
          { "name":"applicationPackage","value":"express-example-app-1.0.2.tgz" },
          { "name":"serverName","value":"ds-member-ctrl5" },
          { "name":"clusterName","value":"MyCluster" }
          { "name":"keystorePassword","value":"password" },
          { "name":"applicationDir","value":"%2Ftmp%2FnodejsApplications" }
       ]
    }
    주의: applicationDir 변수는 UTF-8 인코딩된 디렉토리 경로입니다. applicationDir 변수는 집합체 제어기의 Node.js 애플리케이션의 위치입니다.

    {"id":3}과 비슷할 수 있는 리턴 토큰을 사용하여 상태 및 결과를 가져오십시오. 출력을 JSON 형식으로 얻을 수 있습니다.

다음에 수행할 작업

배치 상태 및 결과를 요청하고 검토하십시오.

  • 요청된 배치 조작에 대한 배치 토큰의 목록을 가져오십시오.
    GET https://controller_host:controller_port/ibm/api/collective/v1/deployment/deploy
  • 배치 조직의 단기 상태를 가져오십시오. {token}에 대해 4단계의 토큰을 사용하십시오. 따라서, 4단계의 {"id":3} 리턴 토큰의 경우, {token}에 대해 3을 사용하십시오.
    GET https://controller_host:controller_port/ibm/api/collective/v1/deployment/{token}/status 
    배치 중에 API가 IN_PROGRESS를 리턴합니다.
    {"status":{"target_host":"IN_PROGRESS"}}
    배치 후, API는 FINISHED를 리턴합니다.
    {"status":{"target_host":"FINISHED"}}

    또한 배치에 문제가 있는 경우 ERROR의 최종 상태를 얻을 수도 있습니다. 전체 결과를 얻으려면 다음 정보를 사용하십시오. 리턴되는 stdout 및 stderr 정보가 문제점을 진단하는 데 도움이 될 수 있습니다.

  • 배치 조작의 전체 결과를 가져오십시오. {token}에 대해 4단계의 토큰을 사용하십시오. 따라서, 4단계의 {"id":3} 리턴 토큰의 경우, {token}에 대해 3을 사용하십시오.
    GET https://controller_host:controller_port/ibm/api/collective/v1/deployment/{token}/results
    배치가 완료된 후, 결과에 조작에 대한 정보가 들어 있습니다. 다음 예는 FINISHED의 결과를 보여줍니다.
    {"results":[{"host_name":"target_host","status":"FINISHED","result":0,"stdout":"deployment_stdout", "stderr":"deployment_stderr", "deployedArtifactName":"serverName_from_inputVars", "deployedUserDir":"target_host_directory_for_deployed_server"}]}
Node.js 서버를 배치 취소하십시오. 배치 규칙을 지정할 필요가 없습니다. 배치에 사용된 규칙이 배치 시점에 저장되었습니다. 배치 취소를 위해 해당 규칙을 사용할 수 있습니다. 호스트 이름, 사용자 디렉토리 및 서버 이름의 서버 튜플이 서버를 배치 취소하는 데 사용됩니다. 이 튜플은 Admin Center의 탐색 도구에 있는 서버 페이지에 표시됩니다.
  • Node.js 서버를 배치 취소하십시오.
    POST https://controller_host:controller_port/ibm/api/collective/v1/deployment/undeploy
    {     
       "host": "myHostName",
       "userDir":"/root/wlpn",     
       "serverName":"myServerName"
    }
  • 배치 취소 조작에 대한 토큰 목록을 가져오십시오.
    GET https://controller_host:controller_port/ibm/api/collective/v1/deployment/undeploy
    상태 및 결과를 가져오려면 배치와 유사한 단계를 따르십시오.

주제의 유형을 표시하는 아이콘 태스크 주제



시간소인 아이콘 마지막 업데이트 날짜: Friday, 16 September 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_deployservice_nodejs
파일 이름: twlp_deployservice_nodejs.html