Testar diretrizes do pacote

  • Artigo

Importante

A Base de Testes do Microsoft 365 fará a transição para o EOL (fim da vida útil) em 31 de maio de 2024. Estamos comprometidos em trabalhar em estreita colaboração com cada cliente para fornecer suporte e diretrizes para tornar a transição o mais suave possível. Se você tiver dúvidas, preocupações ou precisar de assistência, envie uma solicitação de suporte.

1. Referenciar script

Quando você carrega um arquivo .zip no portal, descompactamos 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 fazer referência a 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 script sem as aspas.

É importante que você esteja ciente do conteúdo em seu arquivo zip antes de carregá-lo. Geralmente, ao fechar uma pasta, seu computador local criará uma pasta main 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, seu arquivo zip pode ter seus arquivos ou conteúdo logo abaixo dele (por exemplo, nenhuma pasta de 2º 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 a instalação autônoma, o lançamento e o 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 em 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 o sucesso
  • Registrar em log a pasta de log específica do script

Cada script precisa ser executado sem vigilância (sem solicitações de usuário) para ser executado com êxito no pipeline de teste.

Observação

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

Cada script deve validar que ele foi executado com êxito. Por exemplo, o script de instalação deve marcar para a existência de determinados binários e/ou chaves de registro no sistema após a conclusão da execução do binário do instalador. Esse marcar 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 conseguir instalar o aplicativo com êxito versus não conseguir iniciá-lo.

Importante

Evite o seguinte:

  • Os scripts não devem reiniciar o computador, se uma reinicialização for necessária, especifique isso durante o upload de seus scripts.
  • Não modifique a Lista de Pesquisa de Sufixo DNS na Configuração de IP do Windows.

Importante

O espaço máximo de disco disponível é de 127 Gb. Pacotes que consomem mais do que essa quantidade de espaço não serão executados.

Importante

Pacotes que interagem com a interface do usuário do Windows devem ter as Credenciais de Autologon habilitadas para serem executadas corretamente.

Importante

Os scripts em pacotes têm um limite de tempo de execução de 60 minutos. A execução de scripts após 60 minutos acabaria.

3. Coleção 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 Aplicativo/scripts/instalação ) pode gerar seus logs para: logs/install.log, de modo que o log final esteja em: Aplicativos/scripts/instalação/logs/install.log

O sistema pegará o install.log arquivo junto com outros arquivos em outras logs pastas e o reunirá para download.

4. Binários de aplicativo

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

Esses binários devem incluir tudo o que for necessário para a instalação do aplicativo (por exemplo, o instalador de aplicativos). Se o aplicativo tiver uma dependência de quaisquer estruturas, 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 da Base de Testes, eles precisam cumprir as regras descritas nas regras de aplicativo/teste .

Próximas etapas

Avançar para o próximo artigo para exibir algumas perguntas frequentes (perguntas frequentes)

Próxima etapa