Ações de versão para implantar um aplicativo para Release Management
Você adiciona ações de liberação para definir a sequência de implantação para cada estágio da liberação. Cada ação usa uma ferramenta específica para executar um comando com um conjunto de argumentos.
Se você não criou seu caminho de versão ainda, vá aqui para fazer isso.
Arraste uma ação de liberação da caixa de ferramentas para adicioná-la à sua sequência de implantação. Use qualquer uma das ações de liberação predefinidas listadas na caixa de ferramentas ou criar suas próprias ações de liberação personalizadas.
Depois de adicionar uma ação de liberação à sequência, você pode editar as variáveis de configuração conforme necessário. Para obter detalhes sobre as ações de liberação predefinidas e suas variáveis de configuração, clique aqui. Localize sobre as ferramentas usadas por ações de versão aqui.
Adicionar uma ação de liberação personalizada
Adicione uma nova ação de liberação e escolha a ferramenta que você deseja que essa ação use. Ou, você pode copiar uma ação existente e usá-la como base para criar uma ação de liberação personalizada. Você não pode editar uma ação de liberação existente.
No Release Management Client, aberto na página Inventário. (Se a página não aparecer, solicite a permissão Pode Gerenciar Inventário.)
Copie a ação que deseja editar ou adicione uma nova ação.
Selecione a ferramenta que você deseja usar com base em seus requisitos para a ação. Escolha Novo para adicionar sua própria ferramenta personalizada se ferramentas predefinidas não pode fazer o que você precisa para essa etapa na sequência de implantação.
Na seção Execução, digite os argumentos necessários com seus tokens no formato necessário. Você deve adicionar esse prefixo e sufixo a cada parâmetro:__. Sempre que você excluir ou adicionar argumentos com seus tokens, eles aparecerão na lista Parâmetros.
Por exemplo, adicione os seguintes argumentos com tokens: -servername __servername__ -switch __onoff__. Agora, servername e onoff aparecem na lista de parâmetros.
Para desativar uma ação de liberação
- Se houver ações que você não deseja que a equipe use, desative-as. Abra a ação na página Inventário e escolha o botão Desativar.
Para reativar uma ação de liberação
Abra a lista Inativo, abra a ação e escolha Ativar.
P e R
P: De quais permissões eu preciso para editar ações de liberação?
R: Para editar ou adicionar ações de liberação, os usuários devem ter a permissão Pode Gerenciar Inventário. Se a permissão não estiver habilitada, a página Inventário não aparecerá.
Quando a opção Sem Ferramenta é selecionada, os campos Comando e Argumentos não podem ser editados, a menos que você tenha a permissão Pode Usar Ferramenta Personalizada em Ações e Componentes. Em Configurar Aplicativos, Componentes, quando o usuário não tem a permissão Pode Usar Ferramenta Personalizada em Ações e Componentes, os campos Comando e Argumentos não podem ser editados quando a opção Sem Ferramenta está selecionada.
Ações e variáveis de configuração para ações de liberação
Gerenciar pools de aplicativos e sites
Criar ou modificar arquivos .ini
Gerenciar bancos de dados do SQL Server
Configurar seus servidores
Gerenciar serviços do Windows
Gerenciar pools de aplicativos e sites
Essas ações usam a ferramenta predefinida IIS Deployer para gerenciar pools de aplicativos, sites, aplicativos Web e diretórios virtuais. Essas ações têm suporte no IIS 7.0, 7.5, 8.0 e 8.5. Para obter detalhes sobre essa ferramenta, consulte aqui.
Ação |
Uso e condições de falha de implantação |
---|---|
|
Criar Pool de Aplicativos: essa ação cria um novo pool de aplicativos no IIS. No IIS 7.0, 7.5, 8.0 e 8.5, se o pool de aplicativos já existir, ele será reconfigurado para coincidir com os valores de variáveis de configuração definidas (variáveis de configuração não definidas não afetam a configuração real do pool de aplicativos). Em versões do IIS anteriores à 7.0, se o pool de aplicativos já existir, a implantação falhará. Configurar Pool de Aplicativos, Reciclar Pool de Aplicativos, Iniciar Pool de Aplicativos ou Parar Pool de Aplicativos: essas ações vão reconfigurar, reciclar, iniciar ou parar um pool de aplicativos. A implantação falhará se o pool de aplicativos não existir. |
|
Criar Site: cria um novo site no IIS. Para o IIS 7.0, 7.5, 8.0 e 8.5. Se o site já existir, ele será reconfigurado para coincidir com os valores de variáveis de configuração definidas (variáveis de configuração não definidas não afetam a configuração real do site). Em versões do IIS anteriores à 7.0, se o pool de aplicativos já existir, a implantação falhará. Configurar Site, Reiniciar Site, Iniciar Site e Interromper Site: essas ações vão reconfigurar, reiniciar, iniciar ou parar um site. A implantação falhará se o site não existir. |
|
Criar Aplicativo Web: cria um novo aplicativo Web no IIS. Para o IIS 7.0, 7.5, 8.0 e 8.5. Se o aplicativo Web já existir, ele será reconfigurado para coincidir com os valores de variáveis de configuração definidas (variáveis de configuração não definidas não afetam a configuração real do aplicativo Web). Em versões do IIS anteriores à 7.0, se o pool de aplicativos já existir, a implantação falhará. Configurar Aplicativo Web reconfigurará um aplicativo Web. A implantação falhará se o aplicativo Web não existir. |
|
Criar Diretório Virtual: cria um diretório virtual no IIS. Para o IIS 7.0, 7.5, 8.0 e 8.5. Se o diretório virtual já existir, ele será reconfigurado para coincidir com os valores de variáveis de configuração definidas (variáveis de configuração não definidas não afetam a configuração real do diretório virtual). Configurar Diretório Virtual reconfigurará um diretório virtual. A implantação falhará se o diretório virtual não existir. |
Variáveis de configuração
Parâmetros |
Obrigatório |
Descrição |
---|---|---|
AppPoolName |
Sim [Ações do pool de aplicativos] Não [ações do site] |
O nome do pool de aplicativos para configurar, criar, reciclar, remover, iniciar ou parar. [Ação do pool de aplicativos] O nome do pool de aplicativos a ser usado para um site novo ou modificado. [ação do site] |
DotNetVersion |
Não |
A versão do .NET Framework a ser usada no pool de aplicativos. Esse parâmetro é permitido somente para o IIS 7.5, 8.0 e 8.5. Os valores permitidos são: v1.0, v1.1, v2.0 ou v4.0. |
IdentityUserDomain |
Não |
Domínio do usuário a ser usado como a identidade do pool de aplicativos. Se não estiver definido e "IdentityUserName" estiver definido, o usuário será considerado um usuário local (ou seja, .\localuser). |
IdentityUserName |
Não |
Nome de usuário a ser usado como a identidade do pool de aplicativos. Se não definido, os parâmetros IdentityUserDomain e IdentityUserPassword são ignorados e o valor padrão do IIS é usado (ou seja, ApplicationPoolIdentity). |
IdentityUserPassword |
Não |
A senha do usuário a ser usada como a identidade do pool de aplicativos. |
Is32BitsAllowed |
Não |
Sinalizador para permitir ou impedir que aplicativos de 32 bits sejam executados no pool de aplicativos. Os valores permitidos são:
|
IsAutoStart |
Não |
Sinalizador que indica se o pool de aplicativos ou site será iniciado automaticamente quando o Windows inicia. Os valores permitidos são:
|
IsPreloadEnabled |
Não |
Sinalizador que indica se a funcionalidade de pré-carregamento está habilitada para um site ou aplicativo Web. Os valores permitidos são:
|
PhysicalPath |
Sim [ação de criação] No [todas as outras ações de diretório virtual, site e aplicativo Web] |
O caminho físico completo do diretório virtual, site ou aplicativo Web. |
PipeLineMode |
Não |
O modo de pipeline gerenciado a ser usado no pool de aplicativos. Os valores permitidos são:
|
PortNumber |
Sim [somente ação de criação] |
O número da porta a ser usada para um site novo ou modificado. |
ProcessIdleTimeOut |
Não |
O número de minutos em que um processo pode ficar ocioso no pool de aplicativos. |
RecycleAfterMinutes |
Não |
Um número fixo de minutos após o qual o pool de aplicativos é reciclado. |
RecycleFixedTime |
Não |
Um horário fixo na qual o pool de aplicativos é reciclado. O formato necessário é HH:MM, por exemplo, 23:58 ou 01:23. |
RecycleKbMemory |
Não |
O número máximo de kilobytes de memória que será usado antes da reciclagem do pool de aplicativos. |
SiteName |
Sim [ação do site] Não [ação do diretório virtual] |
O nome do site para a ser criado, configurado, removido, iniciado ou parado. [ação do site] O nome do site em que reside o diretório virtual. Se não definido, o site padrão será usado. [Ação do diretório virtual] |
StartMode |
Não |
O modo de inicialização a ser usado para o pool de aplicativos. Os valores permitidos são:
|
VirtualDirectoryName |
Sim |
O nome do diretório virtual a ser criado, configurado ou removido. |
WebApplicationName |
Não |
O nome do aplicativo Web em que reside o diretório virtual. Se não definido, o aplicativo Web raiz do site será usado. |
WebAppName |
Sim |
O nome do aplicativo Web a ser configurado, criado ou removido. |
WebSiteName |
Sim [ação do site] Não [ação do aplicativo Web] |
O nome do site para a ser configurado, criado, removido, iniciado ou parado. [ação do site] O nome do site em que reside o aplicativo Web. Se não definido, o site padrão será usado. [Ação do aplicativo Web] |
Criar ou modificar arquivos .ini
Essas ações do arquivo .ini usam a ferramenta INI File Manager para adicionar, modificar ou remover seções e chaves do arquivo. Para obter detalhes sobre essa ferramenta, consulte aqui.
Ação |
Descrição |
---|---|
Criar Chave |
Cria uma nova chave com um valor em uma seção específica de um arquivo .ini. Se o arquivo especificado não existir, a ação o criará. Se a seção especificada não existir, a ação a criará. Se a chave já existir na seção especificada, a ação substituirá seu valor. |
Modificar Chave |
Modifica uma chave existente com um novo valor em uma seção específica de um arquivo .ini. Se o arquivo especificado não existir, a ação o criará. Se a seção especificada não existir, a ação a criará. Se a chave já existir na seção especificada, a ação a adicionará. |
Modificar Valor |
Modifica o valor de uma chave existente em uma seção específica de um arquivo .ini. Se o arquivo especificado não existir, a ação o criará. Se a seção especificada não existir, a ação a criará. Se a chave não existir na seção especificada, a ação a adicionará. |
Remover Chave |
Remove uma chave e seus valores de uma seção específica de um arquivo .ini. Se o arquivo especificado não existir, a ação falhará. Se a seção ou chave especificada não existir, a ação ainda terá êxito. Se você especificar para remover todas as chaves de uma seção, a ação também removerá a seção. |
Modificar Seção |
Altera o nome de uma seção de um arquivo .ini. Se o arquivo especificado não existir, a ação o criará. Se a seção especificada não existir, a ação ainda terá êxito. |
Remover Seção |
Remove uma seção e todas as suas chaves e valores dentro de um arquivo .ini. Se o arquivo especificado não existir, a ação falhará. Se a seção especificada não existir, a ação ainda terá êxito. |
Variáveis de configuração
Parâmetros |
Obrigatório |
Descrição |
---|---|---|
INIFile |
Sim |
O nome e o caminho, conforme necessário, do arquivo .ini a ser modificado. |
KeyName |
Sim |
O nome da chave a ser criada, modificada ou removida. |
KeyValue |
Não |
O novo valor a ser atribuído a uma chave. Se não especificado e o NewKeyName não for especificado, o sistema usará o valor real. Se não especificado e o NewKeyName não for especificado, o valor será vazio. |
NewKeyName |
Não |
O novo nome a ser atribuído a uma chave. Se não especificado, o nome da chave não será alterado. |
NewSectionName |
Não |
O novo nome a ser atribuído a um nome de seção. Se não especificado, as chaves da seção antiga serão colocadas na seção raiz (todas as chaves que estão no início do arquivo antes da primeira seção serão consideradas na raiz). |
SectionName |
Não |
[Ação de criação ou modificação de chave] O nome da seção em que uma chave deve ser adicionada ou modificada. Se não especificado, a ação atualiza a seção raiz.
Observação
Todas as chaves que estão no início do arquivo antes de a primeira seção ser considerada na raiz.
[Ação de renomear] O nome da seção a ser renomeada. Se não especificado, as chaves da seção antiga serão colocadas na seção raiz. [Ação de remover] O nome da seção a ser removida. Se não especificado, a seção de raiz será removida. |
Gerenciar bancos de dados do SQL Server
Essas ações usam a ferramenta Database Deployer – Execute Script para criar, excluir, fazer backup e restaurar um banco de dados do SQL Server. Para obter detalhes sobre essa ferramenta, consulte aqui.
Ações |
Descrição |
---|---|
Criar Banco de Dados SQL |
Cria um novo banco de dados. Se o banco de dados já existir, a ação falhará. |
Remover Banco de Dados SQL |
Exclui um banco de dados. Se o banco de dados não existir, a ação falhará. |
Fazer Backup de Banco de Dados SQL |
Faz backup de um banco de dados existente em um caminho especificado. |
Restaurar Banco de Dados SQL |
Restaura um banco de dados de uma fonte especificada. |
Variáveis de configuração
Parâmetros |
Obrigatório |
Descrição |
---|---|---|
DatabaseName |
Sim |
O nome do banco de dados do SQL Server a ser criado, removido, salvo como backup ou restaurado. |
Path |
Sim |
O caminho e o nome do arquivo a ser usado para armazenar o backup do banco de dados. Por exemplo, \\servidor\nomedoarquivo.bak. |
ServerName |
Sim |
O nome do servidor onde o banco de dados SQL será criado, salvo como backup, restaurado ou removido. |
Source |
Sim |
O caminho e o nome do arquivo do backup do banco de dados a ser usado para restaurar o banco de dados. |
Configurar seus servidores
Essas ações podem ser usadas para configurar o computador servidor, se ele executar qualquer sistema operacional Windows. Você pode executar comandos e eliminar processos, bem como gerenciar arquivos, pastas, variáveis de ambiente e chaves e valores de Registro do Windows. O sistema executa essas ações usando várias ferramentas predefinidas do Release Management, incluindo Command Line Runner, Processo do Windows e XCOPY Deployer. Para obter detalhes sobre essas ferramentas, consulte aqui.
Ação |
Observações e condições de falha de implantação |
---|---|
|
Use Executar Linha de Comando para executar um comando usando a identidade do agente de implantação. Use Executar Linha de Comando como Usuário para executar um comando com credenciais de usuário específicas. |
|
Essas ações têm suporte para criar, modificar e excluir arquivos, pastas e alguns atributos. Quando você criar arquivos ou pastas, qualquer diretório pai inexistente da pasta a ser criada também será criado. |
|
Essas ações têm suporte para criar, modificar e excluir variáveis de ambiente. |
|
Essas ações têm suporte para criar, modificar e excluir chaves e valores de Registro. A sequência de implantação falha somente quando você tenta modificar uma chave de Registro que não existe. |
Variáveis de configuração para executar comandos ou eliminar um processo
Parâmetros |
Obrigatório |
Descrição |
---|---|---|
Arguments |
Não |
Os argumentos necessários para executar a linha de comando. |
command |
Sim |
Valor fixo ./WindowsProcess.ps1. |
FilePath |
Não |
Domínio do usuário a ser usado como a identidade do pool de aplicativos. Se não estiver definido e IdentityUserName estiver definido, o usuário será considerado um usuário local (ou seja, .\localuser). |
IsKillProcessTree |
Não |
Indica se é necessário eliminar a árvore de processos. Os valores permitidos são:
|
ProcessName |
Sim |
O nome do processo do Windows a ser eliminado. |
UserDomain |
Não |
O domínio do usuário a ser usado para executar o executável. Quando não especificado,. \localuser é atribuído. |
UserName |
Sim [ação de executar comando] Não [ação de eliminar processo] |
O nome do usuário a ser usado para executar o executável. A conta de usuário que está executando o processo. Se não especificado, o processo será encerrado para todos os usuários. |
UserPassword |
Não |
O senha do usuário a ser usada para executar o executável. |
Variáveis de configuração para gerenciar arquivos e pastas
Parâmetros |
Obrigatório |
Descrição |
---|---|---|
Archive |
Não |
Defina ou redefina o atributo archive para arquivo(s) ou pasta.
|
DestinationFileFolder |
A versão do .NET Framework a ser usada no pool de aplicativos. Esse parâmetro é permitido somente para o IIS 7.5, 8.0 e 8.5. Os valores permitidos são: v1.0, v1.1, v2.0 ou v4.0. |
|
DestinationName |
Sim |
O caminho de destino para onde copiar ou mover arquivos ou pastas. Ou, o novo nome a ser dado ao arquivo ou à pasta que está sendo renomeado(a). |
FileFolderName |
Sim |
Os arquivos ou a pasta de origem que devem ser excluídos, modificados, movidos ou renomeados. Para a ação de excluir, você pode usar caracteres curinga, por exemplo, c:, temp ou *.log. |
FolderName |
Sim |
O nome e o caminho da pasta a ser criada. |
Hidden |
Não |
Defina ou redefina o atributo hidden para arquivos ou pasta.
|
OwnerDomain |
Não |
O domínio do novo proprietário dos arquivos ou da pasta. Quando não especificado,. \localuser é atribuído. |
OwnerDomain |
Sim |
O nome do novo proprietário dos arquivos ou da pasta. |
ReadOnly |
Defina ou redefina o atributo read-only para arquivos ou pasta.
|
|
SourceFileFolder |
Sim |
Os arquivos ou a pasta de origem que devem ser copiados. Você pode usar caracteres curinga, por exemplo, c:, temp ou *.log. |
System |
Defina ou redefina o atributo system para arquivo(s) ou pasta.
|
Variáveis de configuração para ações de variável de ambiente
Parâmetros |
Obrigatório |
Descrição |
---|---|---|
VariableName |
Sim |
O nome da variável a ser criada, modificada ou excluída. |
VariableValue |
Não |
O valor a ser dado à variável adicionada ou modificada. Se nenhum valor for definido, a variável será excluída. |
Variáveis de configuração para ações de Registro do Windows
Parâmetros |
Obrigatório |
Descrição |
---|---|---|
NewRegistryKey |
Sim |
O nome completo do destino da chave de Registro, por exemplo, HKLM, Software ou NEWKEY. |
OperatingSystemType |
Não |
O tipo de sistema operacional no qual criar a chave de Registro. Os valores permitidos são:
|
RegistryData |
Não |
Os dados para afetar o valor de Registro. |
RegistryKey |
Sim |
O nome completo da chave de Registro a ser criada, modificada ou excluída. Por exemplo, HKLM, Software ou NEWKEY. |
RegistryValue |
Sim |
O nome do valor de Registro a ser adicionado ou modificado. |
ValueType |
Não |
O tipo de dados do valor de Registro. Os valores permitidos são:
|
Gerenciar serviços do Windows
Essas ações usam a ferramenta predefinida Windows Service Manager para criar, configurar, excluir, reiniciar, iniciar e parar um serviço do Windows. Para obter detalhes sobre essa ferramenta, consulte aqui.
Ação |
Uso e condições de falha de implantação |
---|---|
|
Use Criar Serviço para criar um novo serviço. A sequência de implantação falhará se o serviço já existir. Use Configurar Serviço para configurar um serviço existente. A sequência de implantação falhará se o serviço não existir. Use Configurar Credenciais de Serviço para configurar um serviço existente com novas credenciais. A sequência de implantação falhará se o serviço não existir. Além disso, a sequência de implantação falhará se o ServiceName especificado não existir quando você especificar que deseja iniciar, parar ou reiniciar um serviço. Ela não falhará se o serviço já estiver iniciado ou parado. |
Variáveis de configuração
Parâmetros |
Obrigatório |
Descrição |
---|---|---|
BinPath |
Não |
Caminho binário e nome do serviço. |
Description |
Sim |
Descrição do serviço a ser criado ou configurado. |
DisplayName |
Não |
Nome do serviço a ser criado ou configurado. |
Password |
Não |
Senha do nome de usuário especificado para iniciar o serviço. |
ServiceName |
Sim |
O nome do serviço a ser criado, configurado, excluído, reciclado, iniciado ou parado. |
StartMode |
Não |
Modo de inicialização do serviço. Os valores permitidos são:
|
UserName |
Sim |
Nome de usuário que será usado para as credenciais iniciarem o serviço. Use o formato DOMÍNIO\USUÁRIO, por exemplo, NT AUTHORITY\NETWORK SERVICE. Caso especifique UserName, você também deve especificar Password. Para redefinir as credenciais para LocalSystem, digite LocalSystem como o usuário e "" como a senha. |