Linux nxArchive 리소스용 DSCDSC for Linux nxArchive Resource

PowerShell DSC(필요한 상태 구성)의 nxArchive 리소스는 Linux 노드 상의 특정 경로에서 보관(.tar, .zip) 파일의 압축을 푸는 메커니즘을 제공합니다.The nxArchive resource in PowerShell Desired State Configuration (DSC) provides a mechanism to unpack archive (.tar, .zip) files at a specific path on a Linux node.

구문Syntax

nxArchive <string> #ResourceName
{
    SourcePath = <string>
    DestinationPath = <string>
    [ Checksum = <string> { ctime | mtime | md5 }  ]
    [ Force = <bool> ]
    [ DependsOn = <string[]> ]
    [ Ensure = <string> { Absent | Present }  ]
}

속성Properties

속성Property 설명Description
SourcePathSourcePath 보관 파일의 원본 경로를 지정합니다.Specifies the source path of the archive file. .tar, .zip 또는 .tar.gz 파일이어야 합니다.This should be a .tar, .zip, or .tar.gz file.
DestinationPathDestinationPath 보관 파일 내용을 추출해 놓을 위치를 지정합니다.Specifies the location where you want to ensure the archive contents are extracted.
체크섬Checksum 소스 보관 파일이 업데이트되었는지 결정할 때 사용할 형식을 정의합니다.Defines the type to use when determining whether the source archive has been updated. 값은 "ctime", "mtime" 또는 "md5"입니다.Values are: "ctime", "mtime", or "md5". 기본값은 "md5"입니다.The default value is "md5".
ForceForce 특정 파일 작업(예: 파일 덮어쓰기나 비어 있지 않은 디렉터리 삭제)을 수행하면 오류가 발생합니다.Certain file operations (such as overwriting a file or deleting a directory that is not empty) will result in an error. Force 속성을 사용하면 이러한 오류가 무시됩니다.Using the Force property overrides such errors. 기본값은 $false입니다.The default value is $false.
DependsOnDependsOn 이 리소스를 구성하려면 먼저 다른 리소스의 구성을 실행해야 함을 나타냅니다.Indicates that the configuration of another resource must run before this resource is configured. 예를 들어, 먼저 실행하려는 리소스 구성 스크립트 블록의 IDResourceName이고 해당 형식이 ResourceType일 경우, 이 속성을 사용하기 위한 구문은 DependsOn = "[ResourceType]ResourceName"입니다.For example, if the ID of the resource configuration script block that you want to run first is ResourceName and its type is ResourceType, the syntax for using this property is DependsOn = "[ResourceType]ResourceName".
EnsureEnsure 보관 파일의 내용이 Destination에 있는지 확인할지 여부를 결정합니다.Determines whether to check if the content of the archive exists at the Destination. 내용이 있도록 하려면 이 속성을 "Present"으로 설정합니다.Set this property to "Present" to ensure the contents exist. 내용이 없도록 하려면 이 속성을 "Absent"으로 설정합니다.Set it to "Absent" to ensure they do not exist. 기본값은 "Present"입니다.The default value is "Present".

예제Example

다음 예제에서는 nxArchive 리소스를 사용하여 website.tar이라는 보관 파일의 내용이 존재하고 지정된 대상에 압축이 풀리도록 하는 방법을 보여줍니다.The following example shows how to use the nxArchive resource to ensure that the contents of an archive file called website.tar exist and are extracted at a given destination.

Import-DSCResource -Module nx

nxFile SyncArchiveFromWeb
{
   Ensure = "Present"
   SourcePath = “http://release.contoso.com/releases/website.tar”
   DestinationPath = "/usr/release/staging/website.tar"
   Type = "File"
   Checksum = “mtime”
}

nxArchive SyncWebDir
{
   SourcePath = “/usr/release/staging/website.tar”
   DestinationPath = “/usr/local/apache2/htdocs/”
   Force = $false
   DependsOn = "[nxFile]SyncArchiveFromWeb"
}