Register-ServiceFabricApplicationType

  • 참조
모듈:
ServiceFabric

Service Fabric 애플리케이션 유형을 등록합니다.

Syntax

Register-ServiceFabricApplicationType
        [-ApplicationPathInImageStore] <String>
        [-ApplicationPackageCleanupPolicy <ApplicationPackageCleanupPolicy>]
        [-Async]
        [-TimeoutSec <Int32>]
        [<CommonParameters>]
Register-ServiceFabricApplicationType
        [-ApplicationPackageDownloadUri] <Uri>
        -ApplicationTypeName <String>
        -ApplicationTypeVersion <String>
        [-Async]
        [-TimeoutSec <Int32>]
        [<CommonParameters>]

Description

Register-ServiceFabricApplicationType cmdlet은 Service Fabric 애플리케이션 유형을 등록합니다. Service Fabric 애플리케이션 배포에 대해 자세히 알아보세요.

애플리케이션 패키지는 이미지 저장소의 상대 위치에 있거나 이전에 외부 위치에 업로드된 파일일 sfpkg 수 있습니다.

저장소 상대 경로를 사용하는 경우 애플리케이션 패키지가 이미지 저장소에 있어야 합니다. Copy-ServiceFabricApplicationPackage를 사용하여 패키지를 이미지 저장소에 복사할 수 있습니다.

외부 저장소의 파일을 사용하는 sfpkg 경우 프로비전은 애플리케이션 유형 정보뿐만 아니라 이전에 업로드된 위치에 sfpkg 대한 다운로드 URI를 제공해야 합니다. sfpkg 파일은 초기 애플리케이션 패키지를 포함하는 zip이며 확장명 ".sfpkg"를 갖습니다. zip 내의 애플리케이션 패키지는 압축되거나 압축이 풀릴 수 있습니다. zip 내의 애플리케이션 패키지 압축은 코드, 패키지 및 데이터 패키지에서 수행됩니다.

만들 sfpkg려면 원래 애플리케이션 패키지가 포함된 폴더로 시작합니다. 필요한 경우 스위치 -CompressPackage 및 -SkipCopy를 사용하여 Copy-ServiceFabricApplicationPackage 를 사용하여 패키지를 압축합니다. 그런 다음 유틸리티를 사용하여 확장 ".sfpkg"가 있는 폴더를 압축합니다. 예를 들어 애플리케이션 패키지 폴더에서 ZipFile.CreateFromDirectory 를 사용합니다.

애플리케이션 유형을 등록한 후 New-ServiceFabricApplication cmdlet을 사용하여 애플리케이션 인스턴스를 만들 수 있습니다. Start-ServiceFabricApplicationUpgrade cmdlet을 사용하여 기존 애플리케이션을 업그레이드합니다.

지정된 버전을 사용하는 애플리케이션 유형이 더 이상 필요하지 않은 경우 Unregister-ServiceFabricApplicationType cmdlet을 사용하여 등록을 취소할 수 있습니다.

Service Fabric 클러스터를 관리하려면 관리자 권한으로 실행 옵션을 사용하여 Windows PowerShell 시작합니다. Service Fabric 클러스터에서 작업을 수행하기 전에 Connect-ServiceFabricCluster cmdlet을 사용하여 클러스터에 대한 연결을 설정합니다.

예제

예제 1: 이미지 저장소 상대 경로에 애플리케이션 유형 등록

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "c:\work\PersistentToDoListService" -ImageStoreConnectionString "file:C:\SfDevCluster\Data\ImageStoreShare" -ApplicationPackagePathInImageStore "PersistentToDoListService"
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListService"

Copy-ServiceFabricApplicationPackage 는 "c:\work\PersistentToDoListService" 폴더에 있는 애플리케이션 패키지를 이미지 저장소에 복사합니다. 패키지는 이미지 저장소의 상대 경로 "PersistentToDoListService"에 복사됩니다.

Register-ServiceFabricApplicationType 명령은 상대 경로 "PersistentToDoListService"에 있는 애플리케이션 유형을 등록합니다.

예제 2: 이미지 저장소 상대 경로 비동기로 애플리케이션 유형 등록

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "c:\work\PersistentToDoListService" -ImageStoreConnectionString "fabric:ImageStore" -ApplicationPackagePathInImageStore "PersistentToDoListService" -CompressPackage
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListService" -Async
PS C:\> Get-ServiceFabricApplicationType

Copy-ServiceFabricApplicationPackage 는 "c:\work\PersistentToDoListService" 폴더에 있는 애플리케이션 패키지를 이미지 저장소에 복사합니다. 애플리케이션 패키지는 이미지 저장소의 상대 경로 "PersistentToDoListService"에 복사됩니다. cmdlet은 압축을 사용하여 패키지 크기를 줄입니다.

Register-ServiceFabricApplicationType 명령은 상대 경로 "PersistentToDoListService"에 있는 애플리케이션 유형을 등록합니다. Register는 비동기에서 수행되며 클러스터에서 명령을 수락하는 즉시 반환됩니다.

Get-ServiceFabricApplicationType 은 클러스터에 등록된 애플리케이션 유형을 가져옵니다. 각 애플리케이션 유형에는 등록 상태가 포함됩니다. cmdlet을 사용하여 등록이 완료되는 시기를 결정할 수 있습니다.

예제 3: 이미지 저장소 상대 경로를 사용하여 대형 애플리케이션 패키지에 대한 애플리케이션 유형 등록

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "c:\work\PersistentToDoListService" -ImageStoreConnectionString "fabric:ImageStore" -ApplicationPackagePathInImageStore "PersistentToDoListService" -CompressPackage -TimeoutSec 2700
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListService" -TimeoutSec 2700

Copy-ServiceFabricApplicationPackage 는 "c:\work\PersistentToDoListService" 폴더에 있는 애플리케이션 패키지를 "PersistentToDoListService" 이미지 저장소 상대 위치의 이미지 저장소에 복사합니다. 초기 패키지가 매우 크므로 명령은 압축하고 복사에 충분한 시간을 허용하도록 더 높은 시간 제한을 포함합니다.

Register-ServiceFabricApplicationType 명령은 상대 경로 "PersistentToDoListService"에 있는 애플리케이션 유형을 등록합니다. 이 명령에는 애플리케이션 패키지가 큰 경우에도 작업을 완료할 수 있도록 더 높은 시간 제한이 포함됩니다.

예제 4: 외부 저장소에서 애플리케이션 유형 등록

PS C:\> Register-ServiceFabricApplicationType -ApplicationPackageDownloadUri "https://sftestresources.blob.core.windows.net:443/sfpkgholder/MyAppPackage.sfpkg" -ApplicationTypeName MyApp -ApplicationTypeVersion V1 -TimeoutSec 2700

지정된 URI에 있는 애플리케이션 패키지를 등록합니다. 애플리케이션 패키지는 이전에 해당 위치에 업로드되어 있어야 하며 READ 액세스를 허용해야 합니다. 패키지가 클 수 있으므로 명령은 큰 프로비전 시간 제한을 지정합니다.

예제 5: 외부 저장소 비동기에서 애플리케이션 유형 등록

PS C:\> Register-ServiceFabricApplicationType -ApplicationPackageDownloadUri "https://sftestresources.blob.core.windows.net:443/sfpkgholder/MyAppPackage.sfpkg" -ApplicationTypeName MyApp -ApplicationTypeVersion V1 -Async
PS C:\> Get-ServiceFabricApplicationType -ApplicationTypeName MyApp -ApplicationTypeVersion V1

지정된 URI에 있는 애플리케이션 패키지를 등록합니다. 애플리케이션 패키지는 이전에 해당 위치에 업로드되어 있어야 하며 READ 액세스를 허용해야 합니다. -Async가 지정되었으므로 클러스터에서 수락하는 즉시 명령이 반환됩니다. Get-ServiceFabricApplicationType 은 필터와 일치하는 클러스터에 등록된 애플리케이션 유형을 가져옵니다. 각 애플리케이션 유형에는 등록 상태가 포함됩니다. cmdlet을 사용하여 등록 진행률을 따르고 등록이 완료되는 시기를 결정할 수 있습니다.

예제 6: 이미지 저장소 상대 경로 및 자동 패키지 정리를 사용하여 애플리케이션 유형 등록

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "c:\work\PersistentToDoListService"

PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListService" -ApplicationPackageCleanupPolicy Automatic

[Copy-ServiceFabricApplicationPackage](./Copy-ServiceFabricApplicationPackage.yml) copies the application package found in the "c:\work\PersistentToDoListService" folder to the image store. The package is copied at the relative path "PersistentToDoListService" in image store.

[Register-ServiceFabricApplicationType](./Register-ServiceFabricApplicationType.yml) command registers the application type found in the relative path "PersistentToDoListService" and deletes the application package "PersistentToDoListService" in the image store after successfully registering the application type. Deleting the application package from the image store after [Register-ServiceFabricApplicationType](./Register-ServiceFabricApplicationType.yml) command is recommended because it removes the temporary package as soon as it's not needed, which ensures that disk space is not consumed unnecessarily.

매개 변수

-ApplicationPackageCleanupPolicy

애플리케이션 유형을 등록하는 데 사용되는 애플리케이션 패키지의 정리 정책을 결정합니다. 정리하지 않으면 애플리케이션 패키지는 디스크 공간을 소비하며 오류가 발생할 수 있습니다. 이 매개 변수는 애플리케이션 유형을 성공적으로 등록한 후 애플리케이션 패키지를 관리하는 방법을 지정합니다(프로비전 성공).

설정되면 AutomaticService Fabric 런타임은 애플리케이션 패키지 정리를 수행할 시기를 결정합니다. 현재 런타임 구현은 애플리케이션 유형을 성공적으로 등록한 후 애플리케이션 패키지를 삭제합니다. 등록에 실패하면 애플리케이션 패키지가 이미지 저장소에서 삭제되지 않습니다.

설정 Manual하면 애플리케이션 패키지가 이미지 저장소에서 삭제되지 않으며 사용자는 Remove-ServiceFabricApplicationPackage cmdlet을 명시적으로 호출하여 이미지 저장소에서 제거해야 합니다.

Service Fabric 클러스터는 정리 정책으로 구성됩니다. 클러스터의 정책을 사용하려면 옵션을 지정합니다 Default . 섹션 아래 Management 의 클러스터 구성 CleanupApplicationPackageOnProvisionSuccess는 정리가 수행되는 방법을 결정합니다. true로 설정하면 성공적으로 프로비전된 후 서비스 패브릭 런타임에 의해 애플리케이션 패키지가 자동으로 삭제됩니다. false로 설정하면 애플리케이션 패키지가 이미지 저장소에서 삭제되지 않습니다. 이 클러스터 구성의 기본값은 v6.4까지 false로 설정되었지만 이후 릴리스에서는 true로 설정할 계획이 있습니다.

Type:ApplicationPackageCleanupPolicy
Accepted values:Invalid, Default, Automatic, Manual
Position:Named
Default value:Default
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationPackageDownloadUri

HTTP 또는 HTTPS 프로토콜을 sfpkg 사용하여 애플리케이션 패키지를 다운로드할 수 있는 애플리케이션 패키지의 경로를 나타냅니다. 패키지는 이전에 이 외부 위치에 업로드되었을 것입니다. URI는 Service Fabric이 파일을 다운로드할 수 있도록 읽기 액세스를 허용해야 합니다. 파일은 sfpkg 초기 애플리케이션 패키지를 포함하는 zip입니다. zip 내의 애플리케이션 패키지는 압축되거나 압축이 풀릴 수 있습니다. zip 내의 애플리케이션 패키지 압축은 코드, 패키지 및 데이터 패키지에서 수행됩니다. 이 압축은 스위치 -CompressPackage와 함께 Copy-ServiceFabricApplicationPackage 를 사용하여 수행할 수 있습니다. sfpkg 파일 확장명은 ".sfpkg"여야 합니다.

Type:Uri
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationPathInImageStore

이미지 저장소에 있는 애플리케이션 유형 패키지의 상대 경로를 지정합니다. 이 경로는 애플리케이션 패키지가 이미지 저장소에 복사될 때 Copy-ServiceFabricApplicationPackage cmdlet에 의해 지정되었습니다.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationTypeName

애플리케이션 매니페스트에 정의된 대로 애플리케이션 유형 이름을 지정합니다. 애플리케이션 유형 이름과 애플리케이션 유형 버전은 애플리케이션 유형을 고유하게 식별합니다. 외부 저장소에서 프로비전할 sfpkg 때 필요합니다.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationTypeVersion

애플리케이션 매니페스트에 정의된 대로 애플리케이션 유형 버전을 지정합니다. 애플리케이션 유형 이름과 애플리케이션 유형 버전은 애플리케이션 유형을 고유하게 식별합니다. 외부 저장소에서 애플리케이션 패키지 파일을 프로비전할 sfpkg 때 필요합니다.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Async

클러스터에서 등록 요청을 수락하는 즉시 명령이 반환됩니다. Get-ServiceFabricApplicationType 명령을 사용하여 등록 요청의 상태를 쿼리합니다. 이 스위치를 사용하면 큰 애플리케이션 패키지를 등록할 때 큰 -TimeoutSec 값을 제공할 필요가 없습니다.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeoutSec

작업의 제한 시간(초)을 지정합니다.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

입력

None

출력

System.Object