Plugins 업로드 지침서

Concept

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

작업흐름

사전요구사항

필요한 고객 데이터

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

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

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

플러그인 파일들

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

text

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

PowerShell 준비

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

text

Import-Module .\Photon.PrivateCloud.Plugin.Client.SAS.psm1

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

text

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

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

Example to get help about Add-PhotonPlugin:

text

Get-Help Add-PhotonPlugin -Detailed

업로드

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

text

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

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

Example output after successful upload:

text

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

검증

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

text

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

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

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

text

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

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

설정

관리화면으로 이동하여 새로운 버전 사용을 위한 플러그인을 설정 합니다.
버전 문자열은 스크립트의 "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
• ...