server | v4 switch to v3  

Plugins 업로드 지침서

이 지첨서는 자체 서버 플러그인을 제작하고 있는 Photon Enterprise Cloud 고객들께만 관련이 있습니다.

Concept

기업 고객들은 프라이빗 Photon 클라우드에 커스텀 플러그인들을 업로드 할 수 있습니다. 각 플러그인 어셈블리는 이름, 버전과 고객ID로 식별됩니다. 추가적으로, 키는 플러그인 업로드를 위한 인증에 필요합니다. 여러개 버전을 가지고 있는 동일한 플러그인 어셈블리는 병렬적으로 사용될 수 있습니다. 특정한 버전의 업로드가 완료된 이후 고객들은 관리화면에서 그들의 고객에게 그 버전에 대한 어플리케이션을 사용할 수 있도록 환경설정을 할 수 있습니다.

Back To Top

작업흐름

사전요구사항

필요한 고객 데이터

업로드 스크립트와 고객 자격 인증서는 요청시에 Enterprise Cloud 고객에게 제공 됩니다.

업로드 과정에 대해 더 나은 설명을 위해서 이 섹션을 통하여 예제에 아래의 값들을 사용할 것 입니다.

  • Customer: "SampleCustomer"
  • Key: "MyKey"
  • Plugin: "MyPlugin"

Back To Top

플러그인 파일들

플러그인 코드를 컴파일 하세요. 결과 파일은 "bin" 폴더(서브폴더가 없음)에 있어야 합니다. "bin" 폴더를 .zip 파일에 추가합니다:

MyPlugin.zip
    - /bin  
        – MyPlugin.dll  
        – PhotonHivePlugin.dll  
        – *.dll

Back To Top

PowerShell 준비

최소한으로 필요한 PowerShell의 버전은 3.0 입니다(Windows Management Framework 3).

플러그인 SDK의 "UploadToPhotonCloud" 폴더에 "Photon.PrivateCloud.Plugin.Client.SAS.zip" 압축파일을 풀어 주세요. 압축을 푼 후 PowerShell에서 스크립트 "Photon.PrivateCloud.Plugin.Client.SAS.psm1" 에 필요한 모듈을 다음 처럼 임포트 합니다:

Import-Module .\Photon.PrivateCloud.Plugin.Client.SAS.psm1
디폴트 윈도우즈 PowerShell이 "제한" 실행 정책이라면 이전의 명령어는 실패 합니다. 실행정책을 변경해야 하며 저희는 Set-ExecutionPolicy RemoteSigned를 이용하여 "RemoteSigned" 로 설정하는 것을 권고 합니다. 현재 실행 정책을 확인하려면 Get-ExecutionPolicy를 이용하시기 바랍니다. 마이크로소프트 TechNet 에서 "Running Scripts" 문서를 읽어 보시기 바랍니다.

모듈에 임포트된 사용할 수 있는 명령어는 아래를 사용해 목록을 볼 수 있습니다:

Get-Module Photon.PrivateCloud.Plugin.Client.SAS | Select-Object -ExpandProperty ExportedCommands

도움말을 보려면 Get-Help 에서 위 목록의 나열된 명령어 이름을 이용 합니다.

Example to get help about Add-PhotonPlugin:

Get-Help Add-PhotonPlugin -Detailed

Back To Top

업로드

"Add-PhotonPlugin" 를 사용하여 플러그인을 업로드 합니다:

Add-PhotonPlugin -Customer SampleCustomer -Plugin MyPlugin -File C:\MyPath\MyPlugin.zip -Key MyKey

업로드 스크립트는 버전 번호를 자동 증가하여 할당해 줍니다. 성공하면 할당된 버전 번호를 리턴 합니다.

Example output after successful upload:

MD5 : 036eb2b33cbfbebdd5bf31474fbf53e4
Name : SampleCustomer/MyPlugin/1/MyPlugin.zip
LastModified : 3/25/16 7:49:58 PM +00:00
Length : 222222
Customer : SampleCustomer
Plugin : MyPlugin
Version : 1

Back To Top

검증

업로드가 완료 되면 플러그인은 프라이빗 Photon 클라우드 서버에게 디플로이를 받습니다. 다음과 같이 특정한 버전에 대한 디플로이 상태를 체크 하세요:

Get-PhotonPluginStatus -Customer SampleCustomer -Plugin MyPlugin -Key MyKey -Version 1

만약 사용할 수 있는 서버 개수와 완료된 서버 개수가 같다면 플러그인이 사용할 준비가 된 것 입니다.

아래의 명령어를 사용하여 계정의 사용 할 수 있는(업로드된)플러그인 전체를 체크 할 수 있습니다.

Get-PhotonPluginList -Customer SampleCustomer [-Plugin MyPlugin] -Key MyKey

"Plugin" 파라미터는 선택사항 입니다. 이름을 지정하여 플러그인 하나에 대한 모든 버전을 검토하고 싶을 때 사용 합니다.

Back To Top

설정

관리화면으로 이동하여 새로운 버전 사용을 위한 플러그인을 설정 합니다. 버전 문자열은 스크립트의 "Version" 문자열과 반드시 일치 해야 합니다. "플러그인 매뉴얼로 이동하여 Enterprise 클라우드 플러그인 환경 설정에 대해서 자세하게 알아 보세요.

환경설정 값의 예:

  • AssemblyName = "MyPlugin.dll" (same as in Plugins SDK)
  • Type = "MyPlugin.PluginFactory" (same as in Plugins SDK)
  • Path = "{SampleCustomer}\{MyPlugin}"
  • Version = {Version} (string from upload script)
  • [CustomKey1] = custom value
  • ...

기술문서 TOP으로 돌아가기