SSH 활동 생성
SSH 네트워크 프로토콜을 사용하는 대상 호스트에서 데이터를 추출하는 활동을 생성합니다.
시작하기 전에
필요한 역할: activity_creator 또는 workflow_admin
이 태스크 정보
활동 템플릿 프로세스 흐름 사용에 대한 지침은 사용자 지정 활동 만들기를 참조하십시오.
프로시저
고급 SSH 스크립트 옵션
대상 호스트에서 스크립트를 실행하려면 MID 서버 스크립트 유형을 지정하고
스크립트 이름을 ${syncFile()} 매개변수에 전달합니다. 시스템은 이 매개변수를 사용하여 MID 서버 스크립트 파일 [ecc_agent_script_file] 테이블에서 이름이 지정된 스크립트를 찾아 대상 호스트에서 실행합니다. 예를 들어 bash 스크립트는 다음과 같이 표현할 수 있습니다. bash ${syncFile("<MID script name>")} argument1 argument2 argument3기본 스크립트(
main_script.bash)는 다른 스크립트(my_include.bash) 및 대상 호스트에 있는 별도의 파일(.my_profile)을 참조할 수 있습니다. 스크립트와 참조된 파일은 모두 ${syncFile()} 매개변수를 사용하여 에 동기화MID 서버되어야 제대로 실행됩니다.source ${syncFile(".my_profile")}
cp ${syncFile("my_include.bash")} /usr/ssmith/my_include.bash
bash ${syncFile("main_script.bash")} one two three four five six
rm /usr/ssmith/my_include.bash인라인 주석이 있는 Python 예제는 다음과 같을 수 있습니다.
set $LIB_DIR=/usr/bin;.
# Sync a file that is referenced inside myF5CreateLBPool.py
cp ${syncFile("specialFunctions.py")} ~/specialFunctions.py
# set up environment variables
source ${syncFile(".python_profile")}
# call script that sets up dependencies on the box from remote package repos
python ${syncFile("setupPythonDependencies.py")} pycontrol
# call a script that requires functions from the package as well as a function from myIncludedFile
python ${syncFile("myF5CreateLBPool.py")} snow_pool myActualValue
# user is responsible for their own cleanup
rm ~/specialFunctions.py 다음에 수행할 작업
- 자동 매핑을 사용하여 출력 및 구문 분석 규칙 작성
- 자동 매핑을 사용하지 않는 경우 출력 변수를 수동으로 생성하고구문 분석 규칙을 만들 수 있습니다
SSH 템플릿 실행 매개변수
활동 디자이너의 전처리 양식에서 입력 프로세스 스크립트를 생성하려면 실행 매개변수를 사용합니다.
명령 필드에 대한 설명은 다음 문서를 참조하십시오 SSH 실행 명령 구성.
주:
이 테이블의 모든 변수에
executionParam. 접두사를 사용해야 합니다.| 이름 | 변수 | 유형 | 사용법 |
|---|---|---|---|
| 소스 | 소스 | 문자열 | 의도된 대상 또는 호스트입니다. |
| 명령 | command | 문자열 | 호스트에서 실행할 코멘트입니다. |
| 디렉터리 | 디렉터리 | 문자열 | 명령을 실행할 호스트의 디렉터리입니다. |
| 자격 증명 태그 | credential_tag | 문자열 | 명령을 실행할 때 사용할 오케스트레이션 자격 증명 태그입니다. |
| MID 역량 | MID 역량 | 문자열(쉼표로 구분) | 필요한 MID 서버 역량 목록입니다. |
| ValueCapabilities | 값 역량 | 해시 맵 배열 | MID 서버를 선택하는 데 사용되는 역량 값입니다. 자세한 내용은 MID 서버 기능을 참조하십시오. 값으로 할당된 추가 역량이 있는 경우 다음 예시를 사용하여 MID 서버 선택을 사용자 지정합니다. |
| 장기간 실행 | long_running | 부울 | 명령이 장기 실행되는지 여부를 나타냅니다. true 값은 명령이 장기 실행 중임을 나타냅니다. |
| sudo 필요 | must_sudo | 부울 | 루트 명령을 실행하기 위해 이 활동이 sudo를 사용해야 하는지 여부를 나타냅니다. true 값은 sudo SSH 자격 증명을 사용해야 함을 나타냅니다. |
SSH 후처리 매개변수 및 페이로드 구문 분석
이러한 매개변수를 사용하여 후처리 스크립트, 페이로드 구문 분석 및 태그 지정을 생성합니다.
| 이름 | 변수 | 유형 | 사용법 |
|---|---|---|---|
| 출력 | 출력 | 문자열 | SSH 명령에서 반환된 출력을 포함합니다. |
| EccSysID | eccSysID | 문자열 | 활동에서 반환한 ECC 큐 입력 메시지와 연결된 참조 ID를 포함합니다. |
| 오류 메시지 | errorMessages | 문자열 | SSH 명령에서 검색된 오류 메시지를 포함합니다. 오류 메시지가 없는 경우 이 값은 null 입니다. |
| 태그 | 태그 | SSH 명령에서 반환된 태그 값의 해시맵 | SSH 명령을 사용하여 출력을 추출하는 데 사용되는 태그를 포함합니다. 태그 출력은 %%tagname%% ... %%와 같이 이중 백분율 기호로 구분됩니다. 다음 형식을 사용하여 명령을 설정합니다.tagname 이 추가된 태그가 있는 JavaScript 해시 맵 객체입니다. |
SSH 실행 명령 구성
만든 입력 변수를 사용하여 Orchestration이 호스트 대상에서 실행하는 명령을 구성합니다.
시작하기 전에
필요한 역할: activity_creator, admin
주:
워크플로우 컨텍스트에서 기능을 실행하지 않고도 MID 서버와 대상 간의 SSH 연결을 테스트할 수 있습니다. 자세한 내용은 테스트 템플릿 출력을 참조하십시오.
프로시저
-
입력 목록에서 변수를 끌어와 명령 필드에 놓습니다.
시스템은 명령에 적합한 구문으로 변수의 형식을 지정합니다.
그림 1. SSH 실행 명령