Instalação da CLI (Interface de Linha de Comando) do CoE (Centro de Excelência) (preterido)

2024-01-10

Observação

A CLI do CoE foi preterida e será removida em uma versão futura. Use o Assistente de Instalação de Projeto do Power Platform para configurar e gerenciar seus projetos do ALM Accelerator for Power Platform.

Para instalar a CLI do CoE:

Baixe o arquivo compactado do Kit de Início do CoE.
Extraia o arquivo zip após o download.
Abra a pasta descompactada e abra a pasta coe-cli
```
cd coe-cli
```

Em seguida, selecione uma instalação local ou instalação do Docker.

Instalação local

Pré-requisitos

Para executar o aplicativo da CLI do CoE, primeiro instale estes componentes:

Observação

A CLI do CoE foi testada com a versão da CLI do Azure até 2.38.0

Uma instalação do Node 16+.

a. https://nodejs.org/en/download/
A CLI do Azure (versão 2.37.0+) é necessária para autenticação do usuário e a integração do Microsoft Entra.

a. Instalar o Azure CLI
PowerShell Core (versão 7.2+)

a. /powershell/scripting/install/instalando-powershell
Git CLI (versão 2.37.2+)

a. https://git-scm.com/downloads

Sem Instalação do Administrador

Se não tiver direitos de administração, você poderá usar a Instalação Não Administrativa

Verificação de pré-requisitos

Para verificar se os pré-requisitos foram instalados corretamente e se as versões corretas estão instaladas, use os comandos a seguir no prompt de comando.

Verifique a versão do nó.
```
node --version
```
Verifique a versão da CLI do Azure.
```
az --version
```

Instalar

Instale as dependências do aplicativo.
```
npm install
```
Compile o aplicativo.
```
npm run build
```
Vincule ao aplicativo da CLI do CoE.
```
npm link
```

Observações

No Windows, pode ser necessário adicionar %APPDATA%\npm à sua variável de ambiente PATH para acessar o comando coe.
Instale a CLI do Azure. Siga as instruções de instalação para o seu sistema operacional em Instalar a CLI do Azure.

Instalação do Docker

Um método de instalação é via Docker.

Pré-requisitos do Docker

Para executar o aplicativo da CLI do CoE, você precisa do software a seguir.

Uma instalação local do Docker. A instalação pode ser da Community Edition ou Enterprise Edition. Se você estiver instalando em um ambiente de área de trabalho, normalmente escolherá uma implantação da Community Edition.

Etapas de instalação do Docker

Nota

Em alguns sistemas operacionais, pode ser necessário usar sudo antes de cada um dos comandos do Docker.

Crie uma imagem do docker.
```
cd coe-cli
docker build -t coe-cli . 
```
Uso da imagem do docker.
```
docker run -it --rm coe-cli
```

Esse comando inicia um novo console interativo (-it) e remove o contêiner do Docker (--rm) quando a sessão do console é encerrada. O uso de --rm garante que todas as credenciais armazenadas em cache serão removidas quando você sair.

Próximas etapas

Instalar o ALM Accelerator