Diretrizes de pacote de teste

1. Script referenciando

Quando você carrega um .zip no portal, descompactaremos todo o conteúdo desse arquivo em uma pasta raiz. Você não precisa escrever nenhum código para fazer essa operação inicial de descompactação. Você também pode referenciar qualquer arquivo no .zip usando o caminho relativo ao arquivo zip carregado.

No exemplo abaixo, mostramos como você pode referenciar seus binários/scripts do campo de entrada na guia Tarefas. O texto em azul deve ser inserido no campo Caminho do scriptsem as aspas.

É importante que você esteja ciente do conteúdo em seu arquivo zip antes de carregá-lo. Muitas vezes, ao compactar uma pasta, o computador local criará uma pasta principal sob o arquivo zip. Nesse caso, a referência será conforme mostrado em negrito abaixo:

Contoso_App_Folder.zip:

├── Contoso_App_Folder

│   ├── file1.exe

│   ├── ScriptX.ps1

│   ├── folder1

│      ├── file3.exe

│      ├── script.ps1
  • ScriptX.ps1 - "Contoso_App_Folder/ScriptX.ps1"
  • Script.ps1 - "Contoso_App_Folder/folder1/script.ps1"

Outras vezes, o arquivo zip pode ter seus arquivos ou conteúdo logo abaixo dele (por exemplo, nenhuma pasta de segundo nível):

Zip_file_uploaded.zip:

├── file1.exe

├── ScriptX.ps1

├── folder1

│   ├── file3.exe

│   ├── script.ps1
  • ScriptX.ps1 - "ScriptX.ps1"
  • Script.ps1 - "folder1/script.ps1"

2. Execução de script

Testes fora de caixa: O pacote de aplicativos precisa conter pelo menos três scripts do PowerShell. Esses scripts executarão instalação autônoma, inicialização e fechamento do aplicativo e suas dependências. Cada script deve lidar com a verificação de seus próprios pré-requisitos, validando seu próprio sucesso e limpando depois de si mesmo (se necessário).

Testes funcionais: O pacote de aplicativos precisa conter pelo menos um script do PowerShell. Quando mais de um script é fornecido, os scripts são executados na sequência de upload e uma falha em um script específico impedirá a execução de scripts subsequentes.

Requisitos de script

  • PowerShell versão 5.1+
  • Execução autônoma
  • Código de retorno de erro
  • Validar êxito
  • Registro em log na pasta de log específica do script

Cada script precisa ser executado de forma autônoma (sem prompts de usuário) para ser executado com êxito no pipeline de teste.

Observação

Os scripts devem retornar "0" após a conclusão bem-sucedida e um código de erro diferente de zero se ocorrer algum erro durante a execução.

Cada script deve validar se ele foi executado com êxito. Por exemplo, o script de instalação deve verificar a existência de determinados binários e/ou chaves do Registro no sistema após a conclusão da execução do binário do instalador. Essa verificação ajuda a garantir com um grau razoável de confiança que a instalação foi bem-sucedida.

A validação é necessária para diagnosticar corretamente onde ocorrem erros durante uma execução de teste. Por exemplo, se o script não for capaz de instalar o aplicativo com êxito em vez de não poder inobilá-lo.

Importante

Evite o seguinte: Os scripts não devem reinicializar o computador. Se uma reinicialização for necessária, especifique-a durante o upload de seus scripts.

3. Coleta de logs

Cada script deve gerar todos os logs gerados em uma pasta chamada logs. Todas as pastas no diretório nomeado logs serão copiadas e apresentadas para download na Test Results página.

Por exemplo, o script de instalação (que pode estar localizado no diretório App/scripts/install ) pode gerar seus logs para: logs/install.log, de modo que o log final esteja em: Apps/scripts/install/logs/install.log

O sistema pegará o arquivo install.log junto com outros arquivos logs dentro de outras pastas e o agrupará para download.

4. Binários do aplicativo

Todos os binários e dependências devem ser incluídos no arquivo zip único.

Esses binários devem incluir tudo o que é necessário para a instalação do aplicativo (por exemplo, o instalador do aplicativo). Se o aplicativo tiver uma dependência em qualquer estrutura, como .NET Core/Standard ou .NET Framework, essas estruturas deverão ser incluídas no arquivo e referenciadas corretamente nos scripts fornecidos.

Observação

O arquivo zip carregado não pode ter espaços ou caracteres especiais em seu nome

5. Regras de aplicativo/teste

Para que seus aplicativos/testes sejam executados corretamente na infraestrutura base de teste, eles precisam estar em conformidade com as regras descritas nas regras de aplicativo /teste .

Próximas etapas

Avance para o próximo artigo para exibir algumas perguntas frequentes (faq)