이 페이지의 내용
Contrail Command 설치
이 예제를 사용하여 Contrail Command Docker 컨테이너 이미지를 설치합니다.
Contrail Command는 Contrail Cloud 및 Contrail Enterprise Multicloud 솔루션을 위한 GUI입니다. 패브릭 언더레이, 오버레이 네트워크 및 가상 엔드포인트, 클라우드 서비스용 AppFormix 성능 및 리소스 모니터링 애플리케이션을 위한 단일 관리 접점을 나타냅니다.
또한 Contrail Command는 OpenStack 클러스터의 구성과 해당 클러스터 내 Contrail의 통합을 단순화합니다. Contrail Command는 오케스트레이터와의 통합을 용이하게 하는 워크플로우를 제공하고 처음에는 OpenStack Kolla에 대한 지원을 제공함으로써 통합을 간단한 작업으로 만듭니다.
Contrail Command를 오케스트레이터와 통합한 후 Contrail Command를 사용하여 오버레이 네트워크 생성, 플레이버 생성, 워크로드 스핀업, 오버레이 네트워크에 워크로드 연결, 통신 경로 제어를 위한 방화벽 권한 설정 등의 일반적인 작업을 수행할 수 있습니다. 이러한 일반적인 작업의 경우 Orchestrator의 UI(예: OpenStack 대시보드)를 사용할 필요가 없습니다.
일반적으로 Contrail Command를 사용하여 다음과 같은 자동화된 워크플로우를 수행할 수 있습니다.
Contrail 및 Kolla 기반 OpenStack 클러스터를 구축합니다.
언더레이 및 물리적 디바이스, 오버레이 및 가상 엔드포인트, 엔드 투 엔드 정책 및 제어를 모니터링하고 관리합니다.
베어메탈 서버, 가상 머신, 컨테이너에서 실행되는 워크로드를 오케스트레이션합니다.
데이터센터 IP 패브릭을 검색하고 관리합니다.
대부분의 워크플로는 인텐트 기반이므로 해당되는 경우 템플릿과 마법사를 사용하여 워크플로를 구성합니다.
요구 사항
Contrail Command 서버의 시스템 요구 사항은 다음과 같습니다.
다음을 포함하는 VM 또는 물리적 x86 서버:
vCPU 4개
32 기가바이트 램
모든 사용자 저장소가 "/" 파티션에 있는 100GB 디스크(즉, "/home" 파티션이 있는 경우 제거하고 "/" 파티션을 확보된 저장소의 양만큼 늘림)
VM 또는 물리적 서버(이하 Contrail Command 서버라고 함)와의 인터넷 액세스
사용 중인 Contrail Networking 버전을 지원하는 CentOS 버전을 실행합니다.
CentOS 7에서 Contrail Command를 정기적으로 테스트하지만, Contrail Command는 다른 일반적인 Linux 버전에서도 작동합니다. Contrail Networking 및 오케스트레이션 플랫폼 조합으로 지원되는 CentOS 버전 목록은 Contrail Networking 지원 플랫폼 목록을 참조하십시오.
명령을 사용하여 업데이트된 패키지와 함께 CentOS를 설치할 수 있습니다
yum update.관리 네트워크에 연결된 IP 인터페이스입니다. Contrail Command는 이 인터페이스를 통해 Contrail 및 OpenStack 클러스터를 관리합니다.
SSH 액세스
hub.juniper.net 레지스트리에 대한 액세스 권한. 자세한 내용은 Contrail Registry 19XX에 대한 README 액세스를 참조하십시오.
<container_tag> 자세한 내용은 Contrail Registry 19XX에 대한 액세스 내용을 참조하십시오.
개요
설치
Contrail Command는 한 쌍의 Docker 컨테이너로 구축됩니다. 이미지를 다운로드하고 실행하여 contrail-command-deployer Contrail Command를 설치합니다. 이 이미지는 자체 컨테이너에서 실행되고 Contrail Command 설치가 완료되면 종료됩니다.
시작하기 전에 지정된 요구 사항을 충족하는 CentOS 7 서버를 설정하십시오. 지원되는 플랫폼 목록은 https://www.juniper.net/documentation/en_US/release-independent/contrail/topics/reference/contrail-supported-platforms.pdf 를 참조하십시오.
또한 서버에서 설치된 Python Docker(docker 및 docker-py) 라이브러리를 제거합니다. 필요한 contrail-command-deployer 모든 라이브러리를 자동으로 설치합니다. 새로 설치된 최소 CentOS 7 서버를 사용하는 경우 이러한 Python Docker 라이브러리가 아직 서버에 존재하지 않으므로 아무 조치도 취할 필요가 없습니다.
pip uninstall docker docker-py
Python Docker 라이브러리가 설치되어 있지 않을 때 위의 명령을 실행하면 아무런 문제가 없습니다.
절차
단계별 절차
CentOS 7 서버에서 다음 단계를 수행하여 Contrail Command를 구성하고 설치합니다.
Docker 엔진을 설치하고 시작합니다. 다음 명령 세트는 Docker 리포지토리를 추가하고 Docker Community Edition 버전 18.06을 예제로 설치 및 시작합니다.
yum install -y yum-utils device-mapper-persistent-data lvm2 yum-config-manager --add-repo \ https://download.docker.com/linux/centos/docker-ce.repo yum install -y docker-ce-18.06.0.ce systemctl start docker
hub.juniper.net 에서 Docker 이미지를 가져옵니다
contrail-command-deployer.Secure hub.juniper.net 레지스트리에 액세스하기 위한 자격 증명을 얻는 방법과 사용할 컨테이너 태그의 이름에 대한 자세한 내용은 Contrail Registry 19XX에 대한 액세스 추가 정보를 참조하십시오.
hub.juniper.net 레지스트리에 로그인합니다.
docker login hub.juniper.net \ --username <container_registry_username> \ --password <container_registry_password>
Docker 이미지를 검색합니다
contrail-command-deployer.docker pull hub.juniper.net/contrail/contrail-command-deployer:<container_tag>
여기서 <container_tag> 는 설치하려는 릴리스의 Contrail Command(UI) 컨테이너 구축을 위한 컨테이너 태그입니다. Contrail Networking Release 19 소프트웨어에 대한 액세스를 얻으려면 Contrail Registry 19XX <container_tag> 에 대한 액세스 읽어보기를 참조하십시오.
command_servers.yml 구성 파일을 만듭니다.
command_servers.yml 파일에는 Contrail Command를 설치할 서버의 정보와 컨테이너 레지스트리 및 기타 구성 매개 변수에 대한 정보가 포함되어 있습니다. Contrail Command는 단일 서버, 일반적으로 을
contrail-command-deployer실행하는 동일한 서버(즉, 이 절차에서 사용되는 서버)에서 실행됩니다.를 실행하면
contrail-command-deployercommand_servers.yml 파일을 읽고 처리합니다. 이 파일의 예는 #sample-command-servers__sample-command-servers-51 및 #sample-command-servers__sample-command-servers-50에 나와 있습니다.참고:AppFormix를 배포하려면 파일에 다음 두 줄을
command_servers.yml추가합니다. 파일 맨 위의 "" 바로 뒤 또는 파일 맨 아래에 있는 마지막 두 줄로 ""command_servers---계층 구조 외부에 배치해야 합니다. 다음은 파일 맨 위에 두 줄이 추가되는 예를 보여줍니다.--- user_command_volumes: - /opt/software/appformix:/opt/software/appformix command_servers: server1: ip:컨테이너를 실행하여 Contrail Command를 구축합니다
contrail-command-deployer.새로 설치를 수행하려면:
docker run -td --net host -v \ <ABSOLUTE_PATH_TO_command_servers.yml_FILE>:/command_servers.yml \ --privileged \ --name contrail_command_deployer \ hub.juniper.net/contrail/contrail-command-deployer:<container_tag>
여기서 <ABSOLUTE_PATH_TO_command_servers.yml_FILE> 는 3단계에서 생성한 command_servers.yml 파일의 절대 경로이며<container_tag>, 은(는) 설치하려는 릴리스의 Contrail Command(UI) 컨테이너 구축에 대한 컨테이너 태그입니다.
(선택 사항) 4단계의 진행 상황을 추적합니다.
docker logs -f contrail_command_deployer
설치가 완료되면 Contrail Command 컨테이너가 실행 중인지 확인합니다.
[root@centos254 ~]# docker ps -a CONTAINER ID IMAGE <trimmed> STATUS <trimmed> NAMES 2e62e778aa91 hub.juniper.net/... Up <trimmed> contrail_command c8442860e462 circleci/postgre... Up <trimmed> contrail_psql 57a666e93d1a hub.juniper.net/... Exited <trimmed> contrail_command_deployer
컨테이너는
contrail_commandGUI이고contrail_psql컨테이너는 데이터베이스입니다. 두 컨테이너 모두 Up 상태여야 합니다.컨테이너는
contrail-command-deployer설치가 완료되면 종료되므로 STATUS가 Exited여야 합니다.-
https://<Contrail-Command-Server-IP-Address>:9091을 사용하여 Contrail Command에 로그인합니다. 3단계에서 command_servers.yml 파일에 지정한 사용자 이름과 암호를 사용합니다. 샘플 command_servers.yml 파일의 샘플 command_servers.yml 파일을 사용하는 경우 사용자 이름은 admin 이고 암호는 contrail123입니다.
예제 command_servers.yml 파일
최소 command_servers.yml 파일
다음 샘플 파일에는 Contrail Command를 설치할 때 필요한 최소 구성이 있습니다.
참고: 비밀번호는 설명 목적으로만 이 출력에서 제공됩니다. 사용자 환경에서 조직의 보안 지침에 따라 고유한 암호를 사용하는 것이 좋습니다.
---
command_servers:
server1:
ip: <IP Address> # IP address of server where you want to install Contrail Command
connection: ssh
ssh_user: root
ssh_pass: <contrail command server password>
sudo_pass: <contrail command server root password>
ntpserver: <NTP Server address>
registry_insecure: false
container_registry: hub.juniper.net/contrail
container_tag: <container_tag>
container_registry_username: <registry username>
container_registry_password: <registry password>
config_dir: /etc/contrail
contrail_config:
database:
type: postgres
dialect: postgres
password: contrail123
keystone:
assignment:
data:
users:
admin:
password: contrail123
insecure: true
client:
password: contrail123
전체 command_servers.yml 파일
다음 샘플 파일에는 Contrail Command를 설치할 때 사용할 수 있는 전체 구성 및 지원 매개 변수 목록이 포함되어 있습니다.
참고: 비밀번호는 설명 목적으로만 이 출력에서 제공됩니다. 사용자 환경에서 조직의 보안 지침에 따라 고유한 암호를 사용하는 것이 좋습니다.
---
# User defined volumes
#user_command_volumes:
# - /var/tmp/contrail:/var/tmp/contrail
command_servers:
server1:
ip: <IP Address>
connection: ssh
ssh_user: root
ssh_pass: <contrail command server password>
sudo_pass: <contrail command server root password>
ntpserver: <NTP Server address>
# Specify either container_path
#container_path: /root/contrail-command-051618.tar
# or registry details and container_name
registry_insecure: false
container_registry: hub.juniper.net/contrail
container_name: contrail-command
container_tag: <container_tag>
container_registry_username: <registry username>
container_registry_password: <registry password>
config_dir: /etc/contrail
# contrail command container configurations given here go to /etc/contrail/contrail.yml
contrail_config:
# Database configuration. PostgreSQL supported
database:
type: postgres
dialect: postgres
host: localhost
user: root
password: contrail123
name: contrail_test
# Max Open Connections for DB Server
max_open_conn: 100
connection_retries: 10
retry_period: 3s
# Log Level
log_level: debug
# Cache configuration
cache:
enabled: true
timeout: 10s
max_history: 100000
rdbms:
enabled: true
# Server configuration
server:
enabled: true
read_timeout: 10
write_timeout: 5
log_api: true
address: ":9091"
# TLS Configuration
tls:
enabled: true
key_file: /usr/share/contrail/ssl/cs-key.pem
cert_file: /usr/share/contrail/ssl/cs-cert.pem
# Enable GRPC or not
enable_grpc: false
# Static file config
# key: URL path
# value: file path. (absolute path recommended in production)
static_files:
/: /usr/share/contrail/public
# API Proxy configuration
# key: URL path
# value: String list of backend host
#proxy:
# /contrail:
# - http://localhost:8082
notify_etcd: false
# VNC Replication
enable_vnc_replication: true
# Keystone configuration
keystone:
local: true
assignment:
type: static
data:
domains:
default: &default
id: default
name: default
projects:
admin: &admin
id: admin
name: admin
domain: *default
demo: &demo
id: demo
name: demo
domain: *default
users:
admin:
id: admin
name: Admin
domain: *default
password: contrail123
email: admin@juniper.nets
roles:
- id: admin
name: admin
project: *admin
bob:
id: bob
name: Bob
domain: *default
password: bob_password
email: bob@juniper.net
roles:
- id: Member
name: Member
project: *demo
store:
type: memory
expire: 36000
insecure: true
authurl: https://localhost:9091/keystone/v3
# disable authentication with no_auth true and comment out keystone configuraion.
#no_auth: true
insecure: true
etcd:
endpoints:
- localhost:2379
username: ""
password: ""
path: contrail
watcher:
enabled: false
storage: json
client:
id: admin
password: contrail123
project_name: admin
domain_id: default
schema_root: /
endpoint: https://localhost:9091
compilation:
enabled: false
# Global configuration
plugin_directory: 'etc/plugins/'
number_of_workers: 4
max_job_queue_len: 5
msg_queue_lock_time: 30
msg_index_string: 'MsgIndex'
read_lock_string: "MsgReadLock"
master_election: true
# Plugin configuration
plugin:
handlers:
create_handler: 'HandleCreate'
update_handler: 'HandleUpdate'
delete_handler: 'HandleDelete'
agent:
enabled: true
backend: file
watcher: polling
log_level: debug
# The following are optional parameters used to patch/cherrypick
# revisions into the contrail-ansible-deployer sandbox. These configs
# go into the /etc/contrail/contrail-deploy-config.tmpl file
# cluster_config:
# ansible_fetch_url: "https://review.opencontrail.org/Juniper/contrail-ansible-deployer refs/changes/80/40780/20"
# ansible_cherry_pick_revision: FETCH_HEAD
# ansible_revision: GIT_COMMIT_HASH