이벤트 핸들러 사용¶

SolusVM 2의 이벤트 핸들러를 사용하면 특정 이벤트가 발생할 때 특정 작업이 자동으로 발생하도록 할 수 있습니다. 현재 웹후크는 유일하게 지원되는 이벤트 핸들러 유형입니다. 나중에 다른 이벤트 핸들러 유형이 추가될 수 있습니다.

이벤트 핸들러를 생성할 때 지원되는 이벤트 목록에서 IP 주소 추가, 서버 제거 등 하나 이상의 이벤트를 선택할 수 있습니다. 지원되는 이벤트에 대해서만 이벤트 핸들러를 생성할 수 있습니다. 지원되는 이벤트가 발생할 때마다 관리자 또는 고객에 의해 시작되었는지 여부에 관계없이 해당 이벤트와 연결된 모든 이벤트 처리기가 트리거됩니다.

웹훅 만들기¶

웹훅은 사용자 정의 HTTP/HTTPS 콜백입니다. 이 유형의 이벤트 핸들러가 트리거될 때마다 웹훅을 실행한 다음 SolusVM 2는 웹훅 URL에 POST 요청을 보냅니다. SolusVM 2는 최대 5개의 리디렉션을 추적하며 웹 사이트의 SSL/TLS 인증서(있는 경우)의 유효성을 확인하지 않습니다. 미리 결정된 여러 매개변수는 항상 URL을 통해 전달됩니다(예: 삭제되는 서버의 ID 또는 추가되는 IP 주소). 웹후크는 사용자가 정의한 추가 매개변수를 전달하도록 구성될 수도 있습니다.

웹후크가 트리거될 때마다 SolusVM 2에서 작업이 생성됩니다. 스크립트가 4хх 또는 5хх HTTP 상태 코드를 반환하는 경우 작업은 "실패" 상태가 됩니다.

웹훅을 생성하려면:

SolusVM 2에 로그인합니다.
설정 > 이벤트 핸들러로 이동한 다음 웹훅 추가를 클릭합니다.
웹훅에 고유한 이름을 지정하세요.
웹훅 URL을 지정합니다. 웹훅이 트리거될 때마다 이 URL로 요청이 전송됩니다.
드롭다운 메뉴에서 하나 이상의 이벤트를 선택합니다. 지원되는 이벤트가 발생할 때마다 웹훅이 트리거됩니다.
(선택 사항) 웹훅 URL을 통해 전달될 추가 요청 매개변수를 지정합니다. 매개변수는 JSON 형식이어야 합니다.
(선택 사항) 생성 후 웹훅을 활성화하려면 "활성화" 확인란을 선택합니다. 또는 나중에 웹훅을 활성화할 수 있습니다.
저장을 클릭합니다.

웹훅이 생성되었습니다. 설정 > 이벤트 핸들러에서 찾을 수 있습니다. 생성 중에 웹훅을 활성화한 경우 다음에 지원되는 이벤트가 발생할 때 웹훅이 트리거되고 웹훅 URL로 요청이 전송됩니다.

웹후크 수정, 비활성화, 제거¶

웹훅을 수정하려면 다음 안내를 따르세요.

SolusVM 2에 로그인합니다.
설정 > 이벤트 핸들러로 이동합니다.
수정하려는 웹훅에 해당하는 아이콘을 클릭합니다.
원하는 대로 변경한 다음 저장을 클릭합니다.

이제 변경 사항이 적용됩니다.

웹훅을 활성화하거나 비활성화하려면:

SolusVM 2에 로그인합니다.
설정 > 이벤트 핸들러로 이동합니다.
활성화 또는 비활성화하려는 웹후크에 해당하는 토글 버튼을 클릭하여 "활성화됨"(파란색) 또는 "비활성화됨"(회색)이 표시되도록 합니다.

이제 웹후크가 활성화(또는 비활성화)되었습니다.

웹훅을 삭제하려면 다음 안내를 따르세요.

SolusVM 2에 로그인합니다.
설정 > 이벤트 핸들러로 이동합니다.
삭제하려는 웹훅에 해당하는 아이콘을 클릭한 후 삭제를 클릭하세요.

웹훅이 삭제되었습니다.

Webhooks가 전달하는 매개변수 목록¶

웹후크가 트리거될 때마다 URL을 통해 다음 매개변수를 전달합니다.

crId
crHostname
crStatus (commissioning, configure_network, active, failed, unavailable)
crLicenseType (micro, mini, standard)
serverId
serverIps (예: ["10.0.0.1","10.0.0.2"])
serverHostname
serverUuid
serverStatus(존재하지 않음, 시작됨, 중지됨, 사용할 수 없음)
userId
billingUserId
userEmail
userStatus(활성, 잠김, 일시 중지됨)
userAllowedIps (예: ["10.0.0.1","10.0.0.2"])

웹훅 예¶

WHMCS의 한 컴퓨팅 리소스에서 다른 컴퓨팅 리소스로 마이그레이션된 서버의 IP 주소를 자동으로 업데이트하는 웹후크를 생성할 수 있습니다.

웹훅을 생성하려면:

SSH를 통해 WHMCS 서버에 로그인합니다.
SolusVM 2 WHMCS 애드온과 함께 제공되는 hook_example.php 파일을 찾으세요. 파일은 modules/servers/solusvm2vps/ 디렉터리에 있어야 합니다.
파일의 복사본을 만든 다음 복사본 편집을 시작합니다.
6행에서 exit();를 제거하세요.
$securitySecrets 변수에 비밀을 추가하세요.
SolusVM 2 관리 노드의 IP 주소를 $connectionIPs 변수에 추가하세요.
변경 사항을 저장하다.
SolusVM 2에 로그인합니다.
설정 > 이벤트 핸들러로 이동한 다음 웹훅 추가를 클릭합니다.
웹훅에 고유한 이름을 지정하세요.
편집된 스크립트의 URL을 지정합니다.
드롭다운 메뉴에서 "추가 IP 추가 또는 제거"를 선택합니다.
이 절차의 5단계에서 스크립트에 추가한 비밀을 지정합니다.
```
{
 "secret": "<your secret goes here>"
}
```
'사용' 확인란을 선택한 다음 저장을 클릭합니다.

이제 서버가 마이그레이션될 때마다 WHMCS에서 서버의 IP 주소를 업데이트하는 작업이 SolusVM 2에서 생성됩니다.