이 페이지는 기계 번역을 사용하여 번역되었습니다. 영어 원문을 보려면 여기를 클릭하십시오.

admin-docker-agent

(시스템 명령) User Manager, Issue Tracker 및 기타 Polyspace Access 앱을 관리하기 위해 Cluster Admin 인터페이스를 실행합니다.

페이지 내 모두 축소

구문

admin-docker-agent [OPTIONS]

설명

admin-docker-agent 시스템 명령은 User Manager, Issue Tracker 및 기타 Polyspace® Access™ 앱과 같은 앱을 관리하기 위해 Cluster Admin 인터페이스를 시작합니다.

admin-docker-agent [OPTIONS]는 Cluster Admin 인터페이스를 시작합니다. 추가 OPTIONS를 지정하지 않으면 관리 에이전트는 호스트 이름 localhost를 사용하고 포트 9443에서 HTTP 프로토콜로 시작합니다.

예제

예제

모두 축소

Cluster Admin는 기본적으로 HTTP 프로토콜을 사용합니다. HTTPS 프로토콜로 Cluster Admin를 구성하여 Cluster Admin와 클라이언트 머신 간의 데이터를 암호화합니다. 이 구성을 사용하면 다른 모든 서비스와 클라이언트 머신 간의 통신을 처리하는 API Gateway 서비스에 대한 HTTPS도 활성화됩니다.

여러 노드에 Polyspace Access를 설치하거나 --force-exposing-ports를 사용하여 Admin 에이전트를 시작하는 경우 User Manager, Issue Tracker 및 Polyspace Access 서비스에 대해 별도로 HTTPS를 구성해야 합니다. 서비스에 대한 HTTPS를 구성하려면 Cluster Dashboard에서 Configure Nodes를 클릭하세요.

openssl 툴킷을 사용하여 자체 서명된 SSL 인증서와 개인 키 파일을 만듭니다. 

openssl req -newkey rsa:2048 -new -nodes -x509 -days 365 -keyout self_key.pem -out self_cert.pem
명령을 입력한 후 화면의 지시를 따르세요. 대부분의 필드는 비워둘 수 있지만 Common Name (CN)를 입력해야 합니다. CN은 admin-docker-agent를 실행하는 머신의 정규화된 도메인 이름(FQDN)과 일치해야 합니다. 이 명령은 인증서 파일 self_cert.pem와 개인 키 파일 self_key.pem를 출력합니다.

해당 장비의 FQDN을 얻으려면 Linux®에서는 hostname --fqdn 명령을, Windows®에서는 net config workstation | findstr /C:"Full Computer name" 명령을 사용하세요.

생성한 인증서와 개인 키 파일을 사용하여 admin-docker-agent를 시작하고 머신의 FQDN인 hostName를 지정하세요. hostName는 SSL 인증서의 CN에 대해 입력한 FQDN과 일치해야 합니다. 명령에서 파일의 절대 경로를 지정하세요.

Windows PowerShell 
admin-docker-agent --hostname hostName`
--ssl-cert-file absolutePathTo\self_cert.pem `
--ssl-key-file absolutePathTo\self_key.pem.pem `
--ssl-ca-file absolutePathTo\self_cert.pem
Linux 
./admin-docker-agent --hostname hostName \
--ssl-cert-file absolutePathTo/self_cert.pem \
--ssl-key-file absolutePathTo/self_key.pem.pem \
--ssl-ca-file absolutePathTo/self_cert.pem

이제 https://hostName:9443/admin를 사용하여 브라우저에서 Cluster Admin 웹 인터페이스에 액세스할 수 있습니다.

입력 인수

모두 축소

Cluster Admin의 연결 설정을 지정하고 관리하는 옵션입니다.

일반 옵션

옵션설명

--hostname hostName

Cluster Admin를 실행하는 컴퓨터의 정규화된 도메인 이름을 지정하세요. HTTPS 구성 옵션을 사용하는 경우 이 옵션이 필요합니다. hostName는 SSL 인증서를 얻기 위해 지정한 Common Name (CN)와 일치해야 합니다.

기본 호스트 이름은 localhost입니다.

--port portNumber

Cluster Admin 웹 인터페이스에 접속하는 데 사용하는 서버 포트 번호를 지정하세요.

기본 포트 값은 9443입니다.

--data-dir dirPath

settings.json 파일이 들어 있는 폴더의 절대 경로를 지정하세요.

파일이 존재하지 않으면 Cluster Admin는 지정된 폴더에 파일을 생성합니다.

파일이 이미 존재하는 경우 Cluster Admin는 해당 내용을 재사용하여 설정을 구성합니다.

기본 폴더는 현재 폴더입니다.

--network-name networkName

Polyspace Access, User Manager, Issue Tracker 앱이 사용하는 Docker® 네트워크의 이름을 지정하세요.

예를 들어, 해당 네트워크가 기존 네트워크와 충돌하는 경우 앱에서 기본 mathworks 네트워크를 사용하지 않도록 하려는 경우 이 옵션을 사용하세요.

Docker 네트워크가 기존 네트워크와 충돌하는지 확인하려면 다음 명령을 실행하세요.

docker network inspect networkName
IPAM.Config 노드를 검사하여 네트워크에서 사용되는 IP 범위를 확인합니다. 해당 IP 범위가 다른 서비스에서 사용되는지 확인하려면 네트워크 관리자에게 문의해야 할 수도 있습니다. networkName를 찾으려면 docker network ls 명령을 사용합니다.

새로운 네트워크를 생성하려면 docker network create를 참조하세요.

--force-exposing-ports

단일 노드에 모든 서비스를 설치할 때 서비스의 포트를 노출하려면 이 옵션을 지정하세요. 노출된 포트가 바인딩되는 Docker 호스트 포트를 지정하려면 Cluster Admin를 열고 Configure Nodes를 클릭한 다음 Services 탭으로 이동합니다.

기본적으로 단일 노드에 설치하는 경우 서비스 포트는 노출되지 않습니다.

단일 노드에 설치하지만 타사 도구를 통해 서비스 중 하나와 통신해야 하는 경우(예: PostgreSQL 유틸리티를 사용하여 Polyspace Access 데이터베이스와 통신하는 경우) 이 옵션을 사용합니다.

--reset-passwordCluster Admin 웹 인터페이스에 로그인하는 데 사용하는 비밀번호를 재설정하세요.
--version관리 에이전트의 버전 번호를 표시합니다.
--help도움말 메뉴를 표시합니다.

HTTPS 구성 옵션

Windows 시스템에서는 모든 경로가 로컬 드라이브를 가리켜야 합니다.

옵션설명

--ssl-cert-file absolutePath

SSL 인증서 PEM 파일의 절대 경로를 지정하세요.

--ssl-key-file absolutePath

인증서를 생성하는 데 사용한 SSL 개인 키 PEM 파일의 절대 경로를 지정하세요.

--ssl-ca-file absolutePath

신뢰할 수 있는 인증 기관을 저장하는 인증서 저장소의 절대 경로를 지정하세요. 예를 들어, Linux Debian® 배포판에서는 /etc/ssl/certs/ca-certificates.crt .

자체 서명된 인증서를 사용하는 경우 --ssl-cert-file에 지정한 것과 동일한 파일을 사용하세요.

--restart-gateway

admin-docker-agent를 다시 시작하고 HTTPS 구성 옵션을 변경하거나 다른 포트를 지정한 경우 이 옵션을 사용하여 Gateway 서비스를 다시 시작합니다.

HTTPS 구성 옵션을 변경하거나 다른 포트를 지정한 경우 이 옵션을 사용하여 Gateway 서비스를 다시 시작합니다.

새로운 노드 구성 옵션

여러 대의 컴퓨터에 Polyspace Access를 설치하기로 선택한 경우 이러한 옵션을 사용하여 각 컴퓨터에 노드를 생성하세요. Cluster Dashboard에서 Configure Nodes를 클릭한 다음, Services 탭을 선택하여 서비스를 실행할 노드를 선택합니다.

노드를 생성하기 전에 최소한 한 대의 다른 머신에서 admin-docker-agent 인스턴스가 이미 실행 중이어야 합니다. 이 다른 머신은 main 노드를 호스팅합니다.

옵션설명

--main-host hostName:port

main 노드를 호스팅하는 머신의 호스트 이름과 포트 번호를 지정하세요.

--node-id nodeName

생성하는 노드의 이름입니다. Cluster Admin를 시작하면 Nodes 설정의 Services 탭에 있는 Node 드롭다운 목록에 이 노드가 나열되는 것을 볼 수 있습니다.

버전 내역

R2020b에 개발됨

모두 확장

참고 항목

도움말 항목