Atividades de fluxo de trabalho de gerenciamento de laboratório
Ao personalizar um modelo de fluxo de trabalho do Lab Management (LabDefaultTemplate.11.xaml), você pode usar uma ou mais das atividades predefinidas do Lab Management. Você também pode acessar os objetos criados pelo assistente do Lab Management. Este tópico descreve as atividades e os objetos do Team Foundation Lab Management que estão disponíveis quando você personaliza um modelo de fluxo de trabalho para compilar, implantar e testar seu aplicativo. Para obter informações sobre como usar essas atividades em um fluxo de trabalho personalizado, consulte Personalizando o fluxo de trabalho de gerenciamento de laboratório.
Requisitos
- O Visual Studio Enterprise, Visual Studio Test Professional
Este tópico contém as seções a seguir:
Atividades do Lab Management
Classes do Lab Management
Atividades do Lab Management
A tabela a seguir descreve as atividades individuais de fluxo de trabalho do Lab Management.
Atividade |
Descrição |
|---|---|
CreateLabEnvironment |
Cria um novo ambiente a partir de um modelo armazenado e o implanta no grupo de hosts especificado. |
DeleteLabEnvironment |
Exclui um ambiente. |
DeleteSnapshot |
Exclui um instantâneo de um ambiente. |
ExecuteRemoteTestRun |
Cria uma execução de teste em um ambiente e aguarda sua conclusão. |
GenerateEnvironmentViewerFile |
Gera um arquivo do visualizador de ambiente que tem a ID do link do instantâneo. É usado para se conectar a um instantâneo do ambiente. |
GetBuildLocationAndBuildNumber |
Retorna o local e o número da compilação de um cenário de compilação, implantação e teste. |
GetLabEnvironmentInUseMarker |
Retorna o marcador Em Uso para um ambiente. |
GetLabEnvironmentSnapshotId |
Obtém a ID de um instantâneo de um ambiente. |
GetLabEnvironmentStatus |
Obtém o status do ambiente. |
GetLabEnvironmentUri |
Obtém o URI do ambiente para um determinado nome de ambiente e o nome do local do laboratório. |
InitializeAgentSpecAndEnvironmentVariables |
Analisa os detalhes do script de implantação especificados pela propriedade |
ResetLabEnvironmentInuseMarker |
Redefine o marcador Em Uso para um ambiente. |
RestoreLabEnvironment |
Restaura o ambiente para o instantâneo especificado. |
RunDeploymentScript |
Executa o script de implantação. Em caso de falha, lança ou grava um aviso de compilação conforme especificado na propriedade ThrowOnError. |
RunWorkflow |
Enfileira um novo fluxo de trabalho em um controlador de compilação de um servidor de compilação. |
SaveLabEnvironment |
Cria um novo ambiente e o armazena em um compartilhamento de biblioteca do projeto de equipe. |
SetLabEnvironmentInuseMarker |
Define o marcador Em Uso no ambiente. |
SnapshotLabEnvironment |
Tira um instantâneo de um ambiente. |
StartLabEnvironment |
Inicia o ambiente. |
StopLabEnvironment |
Interrompe o ambiente. |
WaitForTestCapabilityServices |
Aguarda o tempo máximo especificado para o recurso de teste do ambiente estar pronto. No fim do tempo de espera, se o recurso de teste não estiver pronto, uma exceção de tempo limite será gerada. |
WaitForWorkflow |
Tipo de fluxo de trabalho. |
WaitForWorkflowCapabilityServices |
Aguarda a conclusão da compilação na fila por determinado tempo de espera máximo. Se o fluxo de trabalho de compilação não terminar no tempo máximo determinado, a TimeOutException será lançada. A atividade verifica o status da compilação em fila periodicamente para determinar quais compilações foram concluídas. Esse intervalo é configurado usando a propriedade RefreshInterval. |
WriteDeploymentInformation |
Grava as informações da implantação que são incluídas no resumo da compilação. |
CreateLabEnvironment
Cria um novo ambiente a partir de um modelo armazenado e o implanta no grupo de hosts especificado. Essa é uma atividade de execução longa e aguardará até que o novo ambiente seja criado. Se o novo ambiente de laboratório não puder ser criado, essa atividade lançará a exceção LabDeploymentProcessException.
Propriedades
LabEnvironmentName |
O nome do novo ambiente. Se essa propriedade for nula ou vazia, o nome do modelo de ambiente será usado. |
LabEnvironmentTemplateUri |
URI de um modelo de ambiente armazenado. O URI do modelo de ambiente de laboratório pode ser obtido usando a atividade GetLabEnvironmentUri. Obrigatório. |
TeamProjectHostGroupName |
Grupo de hosts onde o novo ambiente será implantado. Se o grupo de hosts especificado não for localizado, a exceção NoTeamProjectHostGroupFoundException será lançada. Obrigatório. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
DeleteLabEnvironment
Exclui um ambiente. Essa é uma atividade de execução longa e aguardará até que o ambiente seja excluído. Se a exclusão do ambiente falhar, essa atividade lançará a exceção LabDeploymentProcessException.
Propriedades
LabEnvironmentUri |
URI do ambiente a ser excluído. O URI do ambiente de laboratório pode ser obtido usando a atividade GetLabEnvironmentUri. Obrigatório. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
DeleteSnapshot
Exclui um instantâneo de um ambiente. Essa é uma atividade de execução longa e aguardará o instantâneo ser excluído. Se a exclusão do instantâneo falhar, essa atividade lançará a exceção LabDeploymentProcessException.
Propriedades
LabEnvironmentUri |
URI do ambiente de laboratório cujo instantâneo será excluído. O URI do ambiente de laboratório pode ser obtido usando a atividade GetLabEnvironmentUri. Obrigatório. |
SnapshotId |
ID do instantâneo a ser excluído. A ID do instantâneo pode ser obtida usando a atividade GetLabEnvironmentSnapshotId. Obrigatório. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
ExecuteRemoteTestRun
Cria uma execução de teste em um ambiente e aguarda sua conclusão. Essa é uma atividade de execução longa que aguarda até o teste ser concluído ou o tempo limite ser atingido. Você pode definir o tempo limite usando a propriedade MaxWaitTime. Essa atividade verifica o status da execução de teste periodicamente para determinar quais execuções de teste foram concluídas. Esse intervalo é configurado usando a propriedade RefreshInterval. A propriedade MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion pode ser usada para especificar o número de horas consecutivas para ignorar erros do Team Foundation Server ao verificar o status de execução do teste.
Valor de retorno
Um objeto TestRunStatistics que armazena os detalhes da execução do teste.
Propriedades
BuildNumber |
Número de compilação em que os testes são executados. |
LabEnvironmentUri |
URI do ambiente no qual os casos de teste serão executados. O URI do ambiente pode ser obtido usando a atividade GetLabEnvironmentUri. |
MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion |
Número máximo de falhas consecutivas que devem ser ignoradas quando a atividade aguardar a execução dos testes. O valor padrão dessa propriedade é 3. |
MaxWaitTime |
TimeSpan que especifica o tempo de espera máximo para a execução do teste terminar. Uma exceção de tempo limite é lançada no final da duração do tempo especificado. O valor padrão é 0 (zero), o que significa que atividade aguarda indefinidamente. |
RefreshInterval |
TimeSpan que especifica o intervalo após o qual o status da execução do teste é atualizado. O valor padrão desse intervalo é 60 segundos. |
TestDirectory |
Caminho para os executáveis do teste. |
TestEnvironment |
Nome do ambiente de teste no qual os casos de teste serão executados. |
TestParameters |
Um objeto RunTestDetails que especifica parâmetros de teste, como o plano de teste, o conjunto de testes, as definições e configurações de teste. Obrigatório. |
Nome |
Nome da execução de teste. Obrigatório. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
GenerateEnvironmentViewerFile
Gera um arquivo do visualizador de ambiente que contém a ID do link do instantâneo. Essa atividade é usada para se conectar a um instantâneo do ambiente. O nome do arquivo do visualizador de ambiente é o nome do instantâneo sem qualquer destes caracteres especiais: @"\[\`~\!@\#$%^&\*()+=\[{\\\]}|\\\\;:',/?\]" + "\"".
Propriedades
FilePath |
Caminho UNC de onde armazenar o arquivo do visualizador de ambiente. A conta do serviço de compilação deve ter permissão de gravação para o caminho. Obrigatório. |
LabEnvironmentUri |
URI do ambiente. O URI do ambiente pode ser obtido usando a atividade GetLabEnvironmentUri. Obrigatório. |
SnapshotId |
ID do instantâneo. A ID do instantâneo pode ser obtida usando a atividade GetLabEnvironmentSnapshotId. Se o instantâneo não for válido, uma exceção InvalidSnapshotException será lançada. Obrigatório. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
GetBuildLocationAndBuildNumber
Retorna o local e o número da compilação de um cenário de compilação, implantação e teste. Se a “compilação de equipe” for selecionada e a compilação do URI for nula, a última compilação boa será selecionada e os detalhes serão retornados. Se a última compilação boa não for localizada, uma exceção System.ArgumentException será lançada. Se a “compilação de equipe” não for selecionada, somente o local da compilação especificado pelo usuário será retornado.
Valor de retorno
String que especifica o local da compilação.
Propriedades
BuildDetails |
Um objeto Microsoft.TeamFoundation.Lab.Workflow.Activities.BuildDetails que contém informações relacionadas à compilação no cenário de compilação, implantação e teste. |
BuildNumber |
O número da compilação selecionada. Esse é um outArgument. É nulo para compilações que não são de equipe. |
SelectedBuild |
Informações de compilação sobre o servidor de compilação. Esse é um outArgument. É nulo para compilações que não são de equipe. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
GetLabEnvironmentInUseMarker
Obtém o marcador em uso para um ambiente.
Valor de retorno
LabEnvironmentInUseMarker que especifica os detalhes do marcador do ambiente.
Propriedades
LabEnvironmentUri |
URI do ambiente. Use a atividade GetLabEnvironmentUri para obter o URI do ambiente. Obrigatório. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
GetLabEnvironmentSnapshotId
Obtém a ID de um instantâneo de um ambiente. Se nenhum instantâneo com o nome especificado for encontrado, essa gerará uma exceção NoSnapshotFoundException.
Valor de retorno
Int64 que especifica o identificador do instantâneo.
Propriedades
LabEnvironmentUri |
URI do ambiente. Use a atividade GetLabEnvironmentUri para obter o URI do ambiente. Obrigatório. |
SnapshotName |
Nome do instantâneo. Obrigatório. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
GetLabEnvironmentStatus
Obtém o status do ambiente.
Valor de retorno
Um valor LabEnvironmentState enumerado que indica o estado atual do ambiente.
Propriedades
LabEnvironmentUri |
URI do ambiente. Use a atividade GetLabEnvironmentUri para obter o URI do ambiente. Obrigatório. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
GetLabEnvironmentUri
Obtém o URI do ambiente para determinado nome de ambiente e nome do local do laboratório. O local do laboratório pode ser um grupo de hosts ou um compartilhamento de biblioteca. Se o ambiente não for encontrado, essa atividade lançará a exceção LabEnvironmentNotFoundException.
Valor de retorno
String que especifica o URI do ambiente.
Propriedades
LabEnvironmentName |
Nome do ambiente. Obrigatório. |
ProjectName |
O nome do projeto de equipe. Se esse valor de propriedade for nulo ou não especificado, o projeto atual de compilação será usado. |
TeamProjectLabLocationName |
Nome do local do laboratório. Pode ser o nome de um grupo de hosts ou o nome de um compartilhamento de biblioteca. Se o local do laboratório não for localizado, a exceção NoLabLocationFoundException será lançada. Obrigatório. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
InitializeAgentSpecAndEnvironmentVariables
Inicializa os argumentos necessários para a atividade RunDeploymentScript. InitializeAgentSpecAndEnvironmentVariables extrai as propriedades das máquinas virtuais no ambiente, que são necessárias para focar o script de implantação nas máquinas.
Valor de retorno
Um objeto ScriptDetails que armazena os detalhes do script que são necessários para a implantação.
Propriedades
BuildLocation |
Caminho do local da compilação. Isso é usado para expandir a macro $(BuildLocation). Obrigatório. |
DeploymentScriptDetails |
Detalhes da implantação do formato "nomedosistemadelaboratório | argumentos de script | diretório de trabalho". Obrigatório. |
LabEnvironmentUri |
URI do ambiente. Use a atividade GetLabEnvironmentUri para obter o URI do ambiente. Obrigatório. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
ResetLabEnvironmentInuseMarker
Redefine o marcador em uso para um ambiente.
Propriedades
LabEnvironmentUri |
URI do ambiente. Use a atividade GetLabEnvironmentUri para obter o URI do ambiente. Obrigatório. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
RestoreLabEnvironment
Restaura o ambiente para o instantâneo especificado. Se o instantâneo não for válido, a atividade lançará a exceção InvalidSnapshotException.
Propriedades
LabEnvironmentUri |
URI do ambiente. Use a atividade GetLabEnvironmentUri para obter o URI do ambiente. Obrigatório. |
SnapshotId |
ID do instantâneo para restaurar o ambiente. A ID do instantâneo pode ser obtida usando a atividade GetLabEnvironmentSnapshotId. Obrigatório. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
RunDeploymentScript
Executa o script de implantação. Se o script falhar, lançará ou gravará um aviso de compilação conforme especificado na propriedade ThrowOnError.
Valor de retorno
Um valor BuildStatus enumerado que especifica o status da operação de implantação.
Propriedades
MaximumAttemptsForNetUse |
Número máximo de tentativas de adicionar o uso real. |
ScriptDetails |
Um objeto de detalhes do script para um sistema de laboratório. Obrigatório. |
SharedLocationForNetUse |
Local que deve ser acessível à conta de serviço de laboratório. |
ThrowOnError |
Sinalizador para indicar se a exceção deve ser lançada para o erro. O valor padrão é True. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
RunWorkflow
Enfileira um novo fluxo de trabalho em um controlador de compilação de um servidor de compilação. Há dois modos de você especificar em que controlador de compilação a compilação deve ser enfileirada:
Use a propriedade LabEnvironmentUri. Se esse ambiente estiver configurado para integração de fluxo de trabalho, ela usará o controlador de compilação do ambiente para o fluxo de trabalho de enfileiramento. Caso contrário, uma exceção LabDeploymentProcessException será lançada.
Use a propriedade BuildControler para especificar o controlador de compilação.
Valor de retorno
Int32 que especifica a ID da compilação enfileirada.
Propriedades
BuildController |
Nome do controlador de compilação. Se essa propriedade e o valor da propriedade LabEnvironmentUri forem nulos ou não especificados, o controlador de compilação atual será usado para enfileirar a compilação. |
BuildDefinition |
Definição de compilação a ser enfileirada. Obrigatório. |
LabEnvironmentUri |
URI do ambiente com recursos de fluxo de trabalho. Use a atividade GetLabEnvironmentUri para obter o URI do ambiente. Obrigatório. |
ProjectName |
O nome do projeto de equipe. Se essa propriedade for nula ou não especificada, o projeto atual de compilação será usado. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
SaveLabEnvironment
Cria um novo ambiente e o armazena em um compartilhamento de biblioteca do projeto de equipe. Essa é uma atividade de execução longa e aguardará até que o ambiente seja salvo. Se a criação do novo ambiente falhar, essa atividade lançará a exceção LabDeploymentProcessException.
Valor de retorno
String que especifica a URL do novo ambiente.
Propriedades
LabEnvironmentName |
Nome do ambiente salvo. Se essa propriedade for nula ou vazia, o nome do ambiente será usado. |
LabEnvironmentUri |
URI do ambiente a ser salvo. Use a atividade GetLabEnvironmentUri para obter o URI do ambiente. Obrigatório. |
TeamProjectLibraryShareName |
Compartilhamento de biblioteca onde o ambiente é armazenado. Se o compartilhamento de biblioteca especificado não for localizado, a exceção NoTeamProjectLibraryShareFoundException será lançada. Obrigatório. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
SetLabEnvironmentInuseMarker
Define o marcador em uso no ambiente.
Propriedades
Comment |
Comentário gravado quando o marcador é definido. |
LabEnvironmentUri |
URI do ambiente. Use a atividade GetLabEnvironmentUri para obter o URI do ambiente. Obrigatório. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
SnapshotLabEnvironment
Tira um instantâneo de um ambiente. Essa é uma atividade de execução longa e aguardará até que o instantâneo do ambiente seja criado. Se a criação do instantâneo falhar, essa atividade lançará a exceção LabDeploymentProcessException.
Valor de retorno
Int64 que especifica a ID do instantâneo.
Propriedades
LabEnvironmentUri |
URI do ambiente cujo instantâneo precisa ser tirado. Use a atividade GetLabEnvironmentUri para obter o URI do ambiente. Obrigatório. |
SnapshotChainId |
Retorna a ID da cadeia de instantâneo. |
SnapshotName |
O nome do instantâneo a ser tirado. Caso essa propriedade seja nula, o valor atual de DateTime será usado como o nome do instantâneo. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
StartLabEnvironment
Inicia o ambiente. Essa é uma atividade de execução longa e aguardará até que o ambiente inicie. Se a inicialização do ambiente falhar, a atividade lançará a exceção LabDeploymentProcessException.
Propriedades
LabEnvironmentUri |
URI do ambiente. Use a atividade GetLabEnvironmentUri para obter o URI do ambiente. Obrigatório. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
StopLabEnvironment
Interrompe o ambiente. Essa é uma atividade de execução longa e aguardará até que o ambiente pare. Se a interrupção do ambiente falhar, a atividade lançará a exceção LabDeploymentProcessException.
Propriedades
LabEnvironmentUri |
URI do ambiente. Use a atividade GetLabEnvironmentUri para obter o URI do ambiente. Obrigatório. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
WaitForTestCapabilityServices
Aguarda o tempo máximo especificado para o recurso de teste do ambiente estar pronto. Se o recurso de teste não estiver pronto no fim do tempo de espera, uma exceção de tempo limite será gerada. Se a propriedade RepairCapabilityBeforeWaitBegins for definida, o recurso de reparo será invocado antes de esperar que o recurso esteja pronto. O tempo de espera máximo pode ser configurado usando a propriedade MaxWaitTime.
Propriedades
LabEnvironmentUri |
URI do ambiente. Use a atividade GetLabEnvironmentUri para obter o URI do ambiente. Obrigatório. |
MaxWaitTime |
Um objeto System.TimeSpan que especifica o tempo de espera máximo para que o recurso esteja pronto. Uma exceção de tempo limite é lançada no final da duração do tempo limite especificado. O valor padrão é 0 (zero), o que significa aguardar indefinidamente. |
RepairCapabilityBeforeWaitBegins |
Se o valor for true, uma tentativa de reparar o recurso será feita antes da espera. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
WaitForWorkflow
Aguarda a conclusão da compilação na fila por determinado tempo de espera máximo. Se o fluxo de trabalho de compilação não terminar no tempo máximo determinado, a TimeOutException será lançada. A atividade verifica o status da compilação em fila periodicamente para determinar quais compilações foram concluídas. Esse intervalo é configurado usando a propriedade RefreshInterval.
Valor de retorno
Um valor T: Microsoft.TeamFoundation.Build.Client.BuildStatus enumerado que indica o status do fluxo de trabalho.
Propriedades
AllowPartiallySucceededBuild |
Se o valor for true, o sucesso parcial será tratado como sucesso. |
BuildDetails |
Um objeto Microsoft.TeamFoundation.Build.Client.IBuildDetail que contém os detalhes da compilação enfileirada no servidor de compilação. Esse é um argumento out. |
LabWorkflowType |
O tipo de fluxo de trabalho. |
MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion |
Número máximo de falhas consecutivas que devem ser ignoradas quando ela aguardar a conclusão do fluxo de trabalho. O valor padrão é 3. Essa propriedade pode ser usada para aumentar a robustez do fluxo de trabalho. |
MaxWaitTime |
Um objeto System.TimeSpan que especifica o tempo de espera máximo para que o fluxo de trabalho termine. Uma exceção de tempo limite é lançada no final da duração do tempo limite especificado. O valor padrão é 0 (zero), o que significa aguardar indefinidamente. |
QueueBuildId |
A ID da compilação enfileirada. Obrigatório. |
RefreshInterval |
Objeto System.TimeSpan que especifica o intervalo após o qual o status do fluxo de trabalho é atualizado. O valor padrão desse intervalo é 60 segundos. |
ThrowOnError |
Se o valor for true, uma exceção será lançada se a compilação falhar. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
WaitForWorkflowCapabilityServices
Aguarda o tempo especificado para o recurso de fluxo de trabalho do ambiente estar pronto. Se o recurso de fluxo de trabalho não estiver pronto no fim do tempo de espera, uma exceção de tempo limite será gerada. Se a propriedade RepairCapabilityBeforeWaitBegins for definida, o recurso de reparo será invocado antes de esperar que o recurso esteja pronto. O tempo de espera máximo pode ser configurado usando a propriedade MaxWaitTime.
Propriedades
LabEnvironmentUri |
URI do ambiente. Use a atividade GetLabEnvironmentUri para obter o URI do ambiente. Obrigatório. |
MaxWaitTime |
Um objeto System.TimeSpan que especifica o tempo de espera máximo para que o recurso esteja pronto. Uma exceção de tempo limite é lançada no final da duração do tempo limite especificado. O valor padrão é 0 (zero), o que significa aguardar indefinidamente. |
RepairCapabilityBeforeWaitBegins |
Se o valor for true, uma tentativa de reparar o recurso será feita antes da espera. |
WaitForComputerNames |
Se o valor for true, aguarde até que os nomes de computador de todas as máquinas virtuais do ambiente estejam disponíveis. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
WriteDeploymentInformation
Grava as informações da implantação que são incluídas no resumo da compilação. A seção de informações de implantação tem três subseções: Build, Deployment e Test. Você pode adicionar informações de implantação a uma subseção específica usando a propriedade DeploymentInformationType. Os links podem ser adicionados às informações de implantação usando a propriedade URL.
Propriedades
Message (Mensagem) |
Mensagem a ser exibida no resumo. Obrigatório. |
Url |
URL ou link opcional para adicionar à mensagem. |
DeploymentInformationType |
Especifica a subseção das informações de implantação dessa mensagem informativa. Use um dos seguintes valores:
|
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
Classes do Lab Management
A tabela a seguir resume as classes do Lab Management que você pode usar no Designer de Fluxo de Trabalho para personalizar um processo de compilação, implantação e teste. As classes fazem parte do namespace Microsoft.TeamFoundation.Lab.Workflow.Activities.
Object |
Descrição |
|---|---|
LabWorkflowDetails |
A classe LabWorkflowDetails contém os dados de configuração do Assistente de Parâmetros de Fluxo de Trabalho de Laboratório. O objeto LabWorkflowDetails contém objetos BuildDetails, RunTestDetails e ScriptDetails. |
BuildDetails |
Armazena os detalhes da compilação para um cenário de compilação, implantação e teste. |
DeploymentDetails |
Armazena os detalhes do parâmetro de teste que são necessários para criar a execução de teste automatizada no fluxo de trabalho de compilação, implantação e teste. |
LabEnvironmentDetails |
Armazena as informações necessárias para identificar o ambiente de laboratório no cenário de compilação, implantação e teste. |
LabEnvironmentInUseMarker |
Armazena os detalhes do marcador Em Uso de um ambiente. |
LabEnvironmentState |
Especifica o estado atual do ambiente. |
RunTestDetails |
Armazena os detalhes do parâmetro de teste que são necessários para criar a execução de teste automatizada. |
ScriptDetails |
Armazena detalhes do script de implantação que são necessários para um cenário de compilação, implantação e teste. |
ScriptDetails |
Armazena detalhes de uma execução de teste. |
LabWorkflowDetails
A classe LabWorkflowDetails contém os dados de configuração do Assistente de Parâmetros de Fluxo de Trabalho de Laboratório. No LabDefaultTemplate, o objeto LabWorkflowDetails de um fluxo de trabalho está contido no argumento LabWorkflowParameters. A classe LabWorkflowDetails contém as seguintes propriedades:
BuildDetails |
Um objeto BuildDetails criado pelo assistente de fluxo de trabalho e que armazena os detalhes da criação para um cenário de compilação, implantação e teste. |
DeploymentDetails |
Um objeto LabEnvironmentDetails criado pelo assistente de fluxo de trabalho e que armazena as informações necessárias para implantação de uma compilação em um cenário de compilação, implantação e teste. |
EnvironmentDetails |
Um objeto LabEnvironmentDetails criado pelo assistente de fluxo de trabalho e que armazena as informações que identificam o ambiente a ser usado para um cenário de compilação, implantação e teste. |
TestParameters |
Um objeto RunTestDetails criado pelo assistente de fluxo de trabalho e que armazena os detalhes do parâmetro de teste que são necessários para criar a execução de teste automatizada. |
BuildDetails
BuildDetails armazena os detalhes da compilação de uma compilação, implantar e testar o cenário.
Propriedades
IsTeamSystemBuild |
Boolean que indica se a compilação usada é do tipo Compilação em Equipe. |
BuildDefinitionUri |
Uri que especifica o URI da definição da compilação. |
BuildDefinitionName |
String que especifica o nome da definição da compilação. |
QueueNewBuild |
Boolean que indica se a nova compilação deve ser enfileirada. |
BuildUri |
Uri que especifica o URI da compilação, se a compilação for do tipo Compilação em Equipe. |
CustomBuildPath |
String que especifica o caminho para a compilação, se a compilação não for do tipo Compilação em Equipe. |
Configuração |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
DeploymentDetails
DeploymentDetails armazena os detalhes do parâmetro de teste que são necessários para criar a execução de teste automatizada no fluxo de trabalho de compilação, implantação e teste. Você pode acessar o objeto DeploymentDetails que é criado pelo assistente do Lab Management usando a propriedade DeploymentDetails do argumento LabWorkflowParameters.
Propriedades
PostDeploymentSnapshotPath |
String que contém o caminho para armazenar o instantâneo pós-implantação. |
PostDeploymentSnapshotName |
String que especifica o nome do instantâneo tirado após a implantação. |
TakePostDeploymentSnapshot |
Boolean que especifica se um instantâneo pós-implantação é necessário. |
Scripts |
Um objeto StringList que contém uma lista de máquinas virtuais com os scripts de implantação correspondentes. |
DeploymentNeeded |
Boolean que especifica se a implantação precisa ser feita. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
LabEnvironmentDetails
LabEnvironmentDetails armazena as informações necessárias para identificar o ambiente de laboratório no cenário de compilação, implantação e teste. Você pode acessar o objeto LabEnvironmentDetails que é criado pelo assistente de fluxo de trabalho do Lab Management usando a propriedade EnvironmentDetails do argumento LabWorkflowParameters.
Propriedades
ProjectName |
String que especifica o nome do projeto de equipe. |
LabEnvironmentName |
Um String que especifica o nome do ambiente de laboratório |
NewLabEnvironmentName |
String que especifica o nome do ambiente de laboratório a ser criado. |
HostGroupName |
String que especifica o nome do grupo de hosts onde o ambiente é implantado. |
LabLibraryShareName |
String que especifica o nome do compartilhamento de biblioteca que contém o modelo de ambiente de laboratório armazenado. |
RevertToSnapshot |
Boolean que indica se o ambiente deve ser revertido em um instantâneo. |
SnapshotName |
String que especifica o nome do instantâneo do ambiente a ser revertido. |
TfsUrl |
String que especifica a URL do Team Foundation Server. |
LabEnvironmentUri |
Uri que especifica o URI do ambiente selecionado. |
Disposition |
Um valor LabEnvironmentDisposition enumerado que indica o status do ambiente. Os valores são: Unknown – o status de ambiente é desconhecido. Active – o ambiente é implantado em um host e pode ser iniciado e executado. Stored – o ambiente é armazenado em um compartilhamento de biblioteca e não pode ser usado até ser implantado. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
RunTestDetails
RunTestDetails armazena os detalhes do parâmetro de teste que são necessários para criar a execução de teste automatizada no fluxo de trabalho de compilação, implantação e teste. Você pode acessar o objeto RunTestDetails que é criado pelo assistente do Lab Management usando a propriedade TestParameters do argumento LabWorkflowParameters.
Propriedades
TfsUrl |
String que especifica a URL do Team Foundation Server. |
Nome do projeto |
String que especifica o nome do projeto de equipe. |
TestConfigurationId |
Int32 que especifica a ID da configuração de teste para a execução de teste. |
TestPlanId |
Int32 que especifica a ID do plano de teste |
TestSuiteIdList |
Um Systems.Collections.Generic.List<int> que contém as IDs numéricas dos conjuntos de testes para executar |
TestSettingsId |
Int32 que especifica a ID das configurações de teste para a execução de teste. |
RunTest |
Boolean que especifica se é para executar o teste. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
ScriptDetails
Fornece detalhes para implantar scripts. Um objeto ScriptDetails é necessário quando você adiciona uma atividade RunDeploymentScript ao designer de fluxo de trabalho. InitializeAgentSpecAndEnvironmentVariables retorna um objeto ScriptDetails.
Propriedades
LabSystemName |
String que especifica o nome do ambiente de laboratório. |
AgentSpec |
Um objeto AgentReservationSpec que contém as marcas associadas a um agente de compilação no sistema de laboratório. |
FileName |
String que especifica o nome do arquivo de script da implantação. |
Argumentos |
String que especifica os argumentos para passar ao script de implantação. |
Diretório de trabalho |
String que especifica o diretório de trabalho do script de implantação no sistema de laboratório. |
EnvironmentVariables |
Um System.Collection.Generic.IDictionary < String, String > que contém pares de nome/valor da variável de ambiente. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
TestRunStatistics
Armazena detalhes de uma execução de teste. Um objeto TestRunStatistics é retornado pela atividade ExecuteRemoteTestRun.
Propriedades
TotalTests |
Int32 que especifica o número total de testes na execução de teste. |
PassedTests |
Int32 que especifica o número total de testes que passaram na execução de teste. |
FailedTests |
Int32 que especifica o número de testes que foram reprovados na execução de teste. |
InconclusiveTests |
Int32 que especifica o número de testes que foram inconclusivos na execução de teste. |
PendingTests |
Int32 que especifica o número de testes que ainda não foram executados na execução de teste. |
AbortedTests |
Int32 que especifica o número de testes que foram anulados na execução de teste. |
InProgressTests |
Int32 que especifica o número de testes que estão em andamento na execução de teste. |
TestRunStatus |
Um valor TestRunState enumerado que especifica o status da execução de teste. |
TestRunId |
Int32 que especifica o identificador da execução de teste. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
LabEnvironmentInUseMarker
Armazena os detalhes do marcador Em Uso de um ambiente. Use a atividade GetLabEnvironmentInUseMarker para retornar um objeto LabEnvironmentInUseMarker.
Propriedades
Utilizador |
String que especifica o usuário que marcou o ambiente. |
Carimbo de data/hora |
DateTime que especifica a hora em que o usuário marcou o ambiente. |
Comment |
String que é especificado pelo usuário que marcou o ambiente. |
No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.
LabEnvironmentState
Uma enumeração que especifica o estado atual do ambiente. O estado de um ambiente de laboratório é determinado basicamente pelos estados das máquinas virtuais que ele contém. Se todas as máquinas virtuais estiverem em um estado estável consistente, o valor de LabEnvironmentState corresponderá a esse estado. Caso contrário, o valor será Mixed ou Failed. Quando uma operação está em andamento no ambiente, o ambiente de laboratório está em estado de transição, que indica a operação em andamento.
LabEnvironmentState tem os seguintes valores:
Unknown
Criando
CreateFailed
CreateCancelling
Atualizando
Armazenado
Starting
Executando
Pausing
Em pausa
Stopping
Parado
CreatingSnapshot
DeletingSnapshot
RestoringSnapshot
Excluindo
DeleteFailed
Excluído
Misto
Falha
UnderMigration