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 설정을 확인하십시오.
프로시저
- 제어기 server.xml 파일에서 집합적 제어기를 위한 사용자 이름 및 비밀번호를 설정하십시오.
예:
<collectiveController user="admin" password="adminpwd" />
- Node.js 애플리케이션을 집합적 제어기에 추가하십시오.
- 설치하기 위한 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 명령 설명을 참조하십시오.
- 집합적 제어기가 액세스할 수 있는 디렉토리에 Node.js 애플리케이션을 두십시오.
- 디렉토리를 가리키는 remoteFileAccess 명령문을 제어기 server.xml
파일에 추가하십시오. 예:
<remoteFileAccess readDir="/tmp/nodejsApplications" />
이 디렉토리는 5단계에서
deployService 배치를 위해 지정되는 applicationDir 입력 변수입니다. applicationDir
디렉토리는 제어기에 있습니다.
- 제어기 server.xml 파일이 제어기 사용자 이름과 비밀번호 및 배치 변수를
정의하는 명령문을 가지고 있는지 확인하십시오. 예:
<collectiveController user="admin" password="adminpwd" />
...
<deployVariable name="appPort" value="9090" increment="1"/>
<deployVariable name="adminPort" value="9453" increment="1"/>
배치 변수는 각 멤버가 대상 호스트에 고유한 포트 번호를 가지고 있을 수 있도록 하는 값을 설정해야 합니다. DeployVariable(deployVariable)을 확인하십시오.
- 집합적 제어기로 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 디렉토리에 파일을 푸시하기 위한 권리를
가지고 있지 않기 때문에 배치에 실패합니다.
- 사용 가능한 배치 규칙을 검토하십시오.
- 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"
...
}
]
}
- 필요한 경우, 제어기 구성에 DeployRules를 추가하여
자체 배치 규칙을 작성하십시오. 배치 규칙(deployRule)을 확인하십시오.
- 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
상태
및 결과를 가져오려면 배치와 유사한 단계를 따르십시오.