예: 테스트
새로운 테스트 에이전트 생성 및 구축 섹션에 따라 테스트 에이전트(테스트에 필요한 만큼)가 생성되었다고 가정합니다.
테스트를 위한 YANG 모델 경로
| 항목 | YANG 모델 경로: /계정/계정/테스트 ... |
|---|---|
| 테스트 | /. |
| 테스트 [id] | /테스트 |
| 자료 | /test/id |
| 이름 | /테스트/이름 |
| 상태 | /테스트/상태 |
| 시작 시간 | /테스트/시작 시간 |
| 최종 시간 | /테스트/종료 시간 |
| report-url | /test/report-url |
| 단계 | /테스트/단계 |
| 단계[id] | /테스트/단계/단계 |
| 이름 | /테스트/단계/단계/이름 |
| 자료 | /테스트/단계/단계/id |
| 시작 시간 | /테스트/단계/단계/시작 시간 |
| 최종 시간 | /테스트/단계/단계/종료 시간 |
| 상태 | /테스트/단계/단계/상태 |
| status-message | /test/step/step/status-message |
| 템플릿 | /템플릿 |
| 템플릿[이름] | /템플릿/템플릿 |
| 이름 | /템플릿/템플릿/이름 |
| 설명 | /템플릿/템플릿/설명 |
| 매개 변수 | /템플릿/템플릿/매개 변수 |
| parameter[key] | /템플릿/템플릿/매개 변수/매개 변수 |
| 키 | /템플릿/템플릿/매개 변수/파라미터/키 |
| 형식 | /템플릿/템플릿/매개 변수/파라미터/유형 |
테스트 오케스트레이션의 전제 조건
- ncclient를 사용하여 NETCONF를 통해 테스트를 시작하려면 먼저 "테스트 및 모니터링" > "템플릿 만들기"의 앱 내 도움말에 자세히 설명된 컨트롤 센터 GUI를 사용하여 테스트 템플릿을 구축해야 합니다. 테스트 템플릿의 시작을 오케스트레이션할 때 해당 템플릿에 "템플릿 입력"으로 지정된 모든 필드가 XML의 매개 변수로 필요합니다.
- Paragon Active Assurance 테스트 실행은 오케스트레이션의 맥락에서 "상태"로 간주됩니다. 상태 데이터는 테스트 에이전트 오케스트레이션 개요 섹션 개요에 언급된 구성 데이터와 달리 구성 데이터베이스에 저장되지 않는 영장이 불가능한 데이터입니다. 이는 기본적으로 컨트롤 센터 GUI의 테스트 또는 템플릿을 변경해도 컨트롤 센터와 구성 데이터베이스 간에 동기화 관련 문제가 발생하지 않습니다.
- 테스트 보고서를 제대로 작성
report-url하려면 컨트롤 센터 URL이 올바르게 구성되었는지 확인해야 합니다. 이 작업은 파일/opt/netrounds-confd/settings.py에서 수행됩니다. 기본적으로 컨트롤 센터 호스트 이름은 다음을 사용하여socket.gethostname()검색됩니다. 이것이 올바른 결과를 제공하지 않으면 이 파일에서 호스트 이름(또는 전체 URL)을 수동으로 설정해야 합니다.
# URL of Control Center without trailing slash. # This is for example used in test report-url. HOSTNAME = socket.gethostname() NETROUNDS_URL = 'https://%s' % HOSTNAME
테스트 시작
새로운 테스트 에이전트 생성 및 구축 섹션에 설명된 대로 명령을 실행합니다.
pyang -f tree netrounds-ncc.yang
YANG 모델을 출력하기 위해 디렉터리 /opt/netrounds-confd/ 에서 을(를) 확인할 수 있습니다. 이 모델에서 ncclient를 사용하여 테스트를 시작하기 위한 RPC는 다음과 같이 보입니다.
+---x start-test | +---w input | | +---w name string | | +---w account -> /accounts/account/name | | +---w template string | | +---w parameters | | +---w parameter* [key] | | +---w key string | | +---w (value-type) | | +--:(integer) | | | +---w integer? int64 | | +--:(float) | | | +---w float? decimal64 | | +--:(string) | | | +---w string? string | | +--:(test-agent-interfaces) | | | +---w test-agent-interfaces | | | +---w test-agent-interface* [account test-agent interface] | | | +---w account -> ../../../../../account | | | +---w test-agent -> deref(../../../../../account)/../test-agents/test-agent/name | | | +---w interface -> deref(../test-agent)/../interfaces/interface/name | | | +---w ip-version? inet:ip-version | | +--:(twamp-reflectors) | | | +---w twamp-reflectors | | | +---w twamp-reflector* [name] | | | +---w name -> deref(../../../../../account)/../twamp-reflectors/twamp-reflector/name | | +--:(y1731-meps) | | | +---w y1731-meps | | | +---w y1731-mep* [name] | | | +---w name -> deref(../../../../../account)/../y1731-meps/y1731-mep/name | | +--:(iptv-channels) | | | +---w iptv-channels | | | +---w iptv-channel* [name] | | | +---w name -> deref(../../../../../account)/../iptv-channels/iptv-channel/name | | +--:(sip-accounts) | | +---w sip-accounts | | +---w sip-account* [account test-agent interface sip-address] | | +---w account -> ../../../../../account | | +---w test-agent -> deref(../../../../../account)/../test-agents/test-agent/name | | +---w interface -> deref(../test-agent)/../interfaces/interface/name | | +---w sip-address -> deref(../../../../../account)/../sip-accounts/sip-account/sip-address | +--ro output | +--ro result test-status-t | +--ro id? uint32 | +--ro error-text? string
설명은 부록 의 범례 섹션을 참조하십시오.
아래 단계는 다음과 같습니다.
- 테스트 에이전트가 Paragon Active Assurance 계정에 등록되었지만 아직 테스트가 시작되지 않았습니다.
- 실행될 테스트 템플릿에서 필요한 입력 매개 변수가 식별됩니다.
- 60초 HTTP 테스트는 ncclient를 사용하여 시작됩니다.
1단계: 처음에는 Paragon Active Assurance 계정에서 테스트가 시작되지 않았습니다. 컨트롤 센터 GUI의 아래 스크린샷을 참조하십시오.
2단계: 이 예에서 테스트를 시작하는 데 사용할 템플릿은 HTTP 테스트 템플릿입니다. 컨트롤 센터 GUI에서 템플릿을 구축할 때와 같이 지정한 두 개의 필수 입력 필드(Clients 및 URL)가 있습니다.
NETCONF 관리자(ncclient)가 구성 데이터베이스에 전달한 XML 구성에서 이러한 매개 변수(그 외)를 정의합니다.
3단계: HTTP 테스트는 ncclient를 사용하여 시작됩니다.
아래는 HTTP 테스트 템플릿에 필요한 구성 정보 및 매개 변수가 지정된 예제 코드입니다. 템플릿 구축 방식에 따라 세부 정보가 달라질 수 있습니다.
각 매개 변수에 <key> 대해 속성을 제공해야 합니다. 핵심은 컨트롤센터의 매개 변수와 Variable name 동일합니다. 다음과 같이 변수 이름을 검사할 수 있습니다.
- 측면 모음에서 테스트를 클릭하고 새 테스트 시퀀스를 선택합니다.
- 내 템플릿을 클릭합니다.
- 관심 템플릿 아래의 편집 링크를 클릭합니다.
- 오른쪽 상단 모서리에서 입력 편집 단추를 클릭합니다.
예를 들어, 기본적으로 변수 이름은 컨트롤 센터에 표시된 디스플레이 이름의 소문자 버전("url"과 "URL"등)입니다. 그러나 컨트롤 센터 GUI에서 변수의 이름을 원하는 대로 바꿀 수 있습니다.
키 외에도 각 매개 변수는 URL의 유형을 지정 <string> 해야 합니다. 유형에 대한 전체 정보를 얻기 위해서는 전체 YANG 모델을 검토해야 합니다. 테스트 에이전트 인터페이스의 경우 아래 코드에서 볼 <clients> 수 있듯이 유형은 더 복잡한 구조를 가지고 있습니다.
with manager.connect(host=args.host, port=args.port, username=args.username,
password=args.password, hostkey_verify=False) as m:
# Run RPC "start-test"
# A template named "HTTP_test" and having two inputs is assumed to exist
xml = """<start-test xmlns="http://ncc.netrounds.com">
<name>Netconf Initiated HTTP test</name>
<account>{account}</account>
<template>HTTP_test</template>
<parameters>
<parameter>
<key>clients</key>
<test-agent-interfaces>
<test-agent-interface>
<account>{account}</account>
<test-agent>TA1</test-agent>
<interface>eth0</interface>
</test-agent-interface>
</test-agent-interfaces>
</parameter>
<parameter>
<key>url</key>
<string>http://www.google.se</string>
</parameter>
</parameters>
</start-test>""".format(account=args.netrounds_account)
# Convert to ElementTree element
elem = to_ele(xml)
print m.dispatch(elem)
이제 ncclient를 사용하여 스크립트를 실행할 수 있습니다. 모든 것이 정확하다고 가정하면 테스트가 시작되고 실행이 제어 센터에 표시됩니다.
테스트가 성공적으로 시작되면 Control Center가 테스트 ID로 응답합니다. 이 예에서 테스트 ID는 3입니다.
<?xml version="1.0" encoding="UTF-8"?> <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="urn:uuid:f08efc54-2086-4d09-af71-5b65fcecabe1" xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0"><id xmlns='http://ncc.netrounds.com'>3</id> </rpc-reply>
테스트 ID는 컨트롤센터 GUI의 테스트 URL에서도 확인할 수 있습니다. 이 예에서 해당 URL은 입니다 https://host/demo/testing/3/.
테스트 결과 검색
테스트 결과를 검색하는 가장 간단한 방법은 테스트 ID를 가리키는 것입니다.
아래는 ID = 3을 통한 위의 HTTP 테스트 결과를 얻기 위한 Python 코드입니다.
with manager.connect(host=args.host, port=args.port, username=args.username,
password=args.password, hostkey_verify=False) as m:
# Get results from test in account
xml = """<accounts xmlns="http://ncc.netrounds.com">
<account>
<name>{account}</name>
<tests>
<test>
<id>{id}</id>
</test>
</tests>
</account>
</accounts>""".format(account=args.netrounds_account,
id=3)
# Convert to ElementTree object
ele = to_ele(m.get(filter=('subtree', xml)).data_xml)
# Convert back to XML string and print
print to_xml(ele, encoding='UTF-8', pretty_print=True)
출력은 다음과 같이 표시됩니다.
<?xml version="1.0" ?>
<data xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0">
<accounts xmlns="http://ncc.netrounds.com">
<account>
<name xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0">demo</name>
<tests>
<test>
<id xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0">3</id>
<name>HTTP</name>
<status>passed</status>
<end-time>2017-01-26T22:23:53+00:00</end-time>
<report-url>https://localhost//demo/testing/3/</report-url>
<steps>
<step>
<id>4</id>
<name>Step 1</name>
<start-time>2017-01-26T22:22:51+00:00</start-time>
<end-time>2017-01-26T22:23:51+00:00</end-time>
<status>passed</status>
<status-message/>
</step>
</steps>
</test>
</tests>
</account>
</accounts>
</data>
테스트 템플릿 내보내기 및 가져오기
테스트 템플릿은 JSON 형식으로 내보내고 해당 형식으로 컨트롤 센터로 다시 지정할 수 있습니다. 이는 컨트롤 센터의 다른 설치에서 테스트 템플릿을 사용하려는 경우에 유용합니다. (템플릿의 초기 생성은 컨트롤 센터 GUI를 통해 가장 잘 처리됩니다.)
다음은 내보내기 및 가져오기를 수행하기 위한 코드입니다.
테스트 템플릿 내보내기
with manager.connect(host=args.host, port=args.port, username=args.username,
password=args.password, hostkey_verify=False) as m:
# Export selected templates from Control Center
# In order to export all templates, remove the <templates></templates> node
export_xml = """
<export-test-templates xmlns="http://ncc.netrounds.com">
<account>{account}</account>
<templates>
<template>
<name>template_udp</name>
</template>
<template>
<name>template_tcp</name>
</template>
</templates>
</export-test-templates>""".format(account=args.netrounds_account)
elem = to_ele(export_xml)
response = m.dispatch(elem)
# Get json config from response
root = ET.fromstring(response._raw)
json_config = root[0].text
print json_config
템플릿은 개체에 json_config 포함되어 있습니다.
테스트 템플릿 가져오기
JSON 구성 개체 보유 테스트 템플릿을 다음과 같이 컨트롤 센터에 다시 지정할 수 있습니다.
with manager.connect(host=args.host, port=args.port, username=args.username,
password=args.password, hostkey_verify=False) as m:
json_string = """
{
"templates":[
{
"input":[
{
"require_bridge":false,
# ...
# Insert rest of JSON string here
# ...
}
],
"version": "2.29",
"export_date": "2019-05-29T12:39:31.172594Z"
}
"""
# Import templates back into Control Center
import_xml = """
<import-test-templates xmlns="http://ncc.netrounds.com">
<account>{account}</account>
<overwrite>false</overwrite>
<data>{data}</data>
</import-test-templates>""".format(
account=args.netrounds_account,
data=json_string)
elem = to_ele(import_xml)
response = m.dispatch(elem)
print response