Recurso nxArchive de DSC para LinuxDSC for Linux nxArchive Resource

O recurso nxArchive na Configuração de Estado Desejado (DSC) do PowerShell fornece um mecanismo para descompactar arquivos mortos (.tar, .zip) em um caminho específico em um nó do Linux.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.

SintaxeSyntax

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

PropriedadesProperties

PropriedadeProperty DescriçãoDescription
SourcePathSourcePath Especifica o caminho de origem do arquivo morto.Specifies the source path of the archive file. Deve ser um arquivo .tar, .zip ou .tar.gz.This should be a .tar, .zip, or .tar.gz file.
DestinationPathDestinationPath Especifica o local onde você deseja garantir que o conteúdo do arquivo seja extraído.Specifies the location where you want to ensure the archive contents are extracted.
Soma de verificaçãoChecksum Define o tipo que deve ser usado ao determinar se o arquivo de origem foi atualizado.Defines the type to use when determining whether the source archive has been updated. Os valores são: "ctime", "mtime" ou "md5".Values are: "ctime", "mtime", or "md5". O valor padrão é "md5".The default value is "md5".
ForceForce Determinadas operações de arquivo (como substituição de um arquivo ou exclusão de um diretório que não esteja vazio) resultarão em erro.Certain file operations (such as overwriting a file or deleting a directory that is not empty) will result in an error. O uso da propriedade Force substitui esses erros.Using the Force property overrides such errors. O valor padrão é $false.The default value is $false.
DependsOnDependsOn Indica que a configuração de outro recurso deve ser executada antes de ele ser configurado.Indicates that the configuration of another resource must run before this resource is configured. Por exemplo, se a ID do bloco de script de configuração do recurso que você deseja executar primeiro for ResourceName e seu tipo for ResourceType, a sintaxe para usar essa propriedade será 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 Determina se é necessário verificar se o conteúdo do arquivo existe em Destination.Determines whether to check if the content of the archive exists at the Destination. Defina essa propriedade como "Present" para garantir que o conteúdo exista.Set this property to "Present" to ensure the contents exist. Defina-a como "Absent" para garantir que não exista.Set it to "Absent" to ensure they do not exist. O valor padrão é "Present".The default value is "Present".

ExemploExample

O exemplo a seguir mostra como usar o recurso nxArchive para garantir que o conteúdo de um arquivo morto chamado website.tar exista e seja extraído em um destino específico.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"
}