Compartilhar via

Variáveis de configuração e variáveis do sistema

  • Artigo

Geralmente, quando você implanta seu aplicativo, é necessário acesso à configuração ou configurações do sistema para o seu script. Dessa forma, você não precisa codificar valores em vários locais quando os valores podem mudar dependendo de uma configuração, compilação, servidor ou versão. Para evitar codificado valores, com o Release Management para Visual Studio 2013 atualização 4 Você pode usar variáveis de configuração e do sistema nos seus scripts vNext versões.

Variáveis de configuração

Variáveis de configuração fornecem configurações reutilizáveis e personalizáveis que estão disponíveis durante a execução da ação. Você pode definir as variáveis de configuração e valores nos servidores de componentes padrão e globalmente e, em seguida, use esses valores em seus scripts do PowerShell e scripts de configuração. E, se você não quiser usar um valor padrão durante a implantação, você pode substituí-la. Um exemplo para usar variáveis de configuração é definir o nome de usuário e senha usados para implantar seu aplicativo no servidor.

Variáveis de configuração podem ser definidas nos níveis globais, servidor, componente e ação.

  • Variáveis de configuração global: definida via Administração > Configurações > variáveis de configuração. Disponível em todos os lugares.

  • Variáveis de configuração do servidor: definida via configurar caminhos > servidor, selecionando um servidor variáveis de configuração. Disponível para ações que implantar seu aplicativo no servidor. Uso de variáveis de servidor específicas, como um nome de usuário e uma senha.

  • Variáveis de configuração do componente: definida via configurar aplicativos > componente, selecionando um componente variáveis de configuração. Disponível para ações que usam o componente.

  • Variáveis de configuração de ação: definida dentro do designer de modelo de versão, as ações disponível.

The order of precedence, from highest to lowest, when a configuration variable name is used in more than one level is Configuration Script file > Action > Component > Server > Global.

Gerenciar variáveis de configuração, no canto inferior esquerdo do modelos de versão e versões modos de exibição são guias denominados variáveis de configuração e variáveis de recurso.

O variáveis de configuração guia exibe as variáveis de configuração em vigor para a ação, para cada estágio.

Configuration variables

O variáveis de recursos guia exibe as variáveis de configuração e os valores que são definidos globalmente, servidores e componentes. (Esses são valores atuais, não um instantâneo de um momento anterior.) Alterações em variáveis de recurso estará em vigor por versões em andamento que iniciar uma nova implantação.

Resource variables

Para adicionar uma variável de configuração dentro de uma ação, no Designer de modelos de versão, abrir uma atividade, clique na seta suspensa no configuração personalizada seção e especifique padrão ou criptografado para o tipo de variável de configuração. (Se usar criptografado, certifique-se de que o ouvinte HTTPS é configurado no servidor onde você implanta seu aplicativo.)

Configuration variable type

Digite o nome da nova variável e fornecer seu valor.

Create a custom configuration variable

Para substituir um valor em uma variável de recurso, clique na + assinar e, em seguida, clique na seta suspensa no configuração personalizada seção. Selecione a variável para personalizar e fornecer um valor.

Set a custom configuration value

Variáveis do sistema

Além das definições de configuração, o script também é necessário acesso às configurações do sistema. Por exemplo, se o script precisa executar ações especiais quando você implanta seu aplicativo em um ambiente de produção, o script pode examinar a variável de ambiente. As variáveis de sistema a seguir estão disponíveis:

  • ApplicationPathCaminho de destino, incluindo o nome do componente, onde o componente é copiado.

  • ApplicationPathRootCaminho de destino onde o componente é copiado.

  • BuildDefinitionCrie definição do componente.

  • BuildDirectoryCrie diretório para o componente.

  • BuildNumberNúmero do componente de compilação.

  • EnvironmentO ambiente da versão.

  • PackageLocationO caminho de origem do qual o componente é copiado. Para compilações caiu para um servidor padrão, o caminho aponta para a id de contêiner. Para compilações solto no Azure, o caminho aponta para o GUID do blob de armazenamento.

  • ReleaseIdA ID da versão; Isso é atribuído pelo gerenciamento de liberação.

  • ReleaseNumberO número da versão.

  • StageO estágio da versão.

  • TagUsado para agrupar o servidor que está executando a ação de marca.

  • TeamProjectProjeto de equipe para o componente.

  • TFSUrlURL do TFS para o componente.

Ao usar a configuração ou variáveis do sistema em scripts, prefixar uma $ para o nome da variável. Por exemplo: $Stage.

Observe que um valor que pode ser atribuído. Por exemplo, se você estiver implantando seu aplicativo em um servidor que não foi agrupado por uma marca, o valor da $Tag variável será atribuído.