Instalar a CLI do CycleCloud

A CLI (Interface de Linha de Comando) do Azure CycleCloud fornece acesso de console ao aplicativo CycleCloud, tornando as funções vistas na GUI disponíveis na linha de comando. Você pode usá-lo para controlar o CycleCloud e os Clusters do CycleCloud diretamente ou por meio de um script.

Pré-requisitos

A CLI do CycleCloud requer uma instalação existente do Python 3.6 ou posterior. Embora a maioria dos sistemas Linux e Mac já tenha uma instalação válida do Python 3, você precisa instalar o Python para Windows.

Arquivo do instalador da CLI do CycleCloud

Você obtém o instalador da CLI como parte do pacote de instalação do CycleCloud. Selecione ? no canto superior direito da interface do usuário para acessar a página sobre . Use o botão Baixar Ferramentas da CLI para baixar o instalador no navegador.

Você também pode baixar o instalador diretamente da linha de comando usando o comando a seguir. Se a instância do CycleCloud não tiver um certificado que corresponda ao nome do host, talvez seja necessário adicionar a flag --no-check-certificate ao comando a seguir wget .

wget https://<your CycleCloud domain name>/static/tools/cyclecloud-cli.zip

Instalação da CLI do CycleCloud para Linux

Extraia o conteúdo de cyclecloud-cli.zip para um diretório temporário:

cd /tmp
unzip /opt/cycle_server/tools/cyclecloud-cli.zip

Esta etapa cria um subdiretório chamado cyclecloud-cli-installer. Para concluir a instalação, execute o script install.sh neste diretório:

cd /tmp/cyclecloud-cli-installer
./install.sh

A CLI do CycleCloud é instalada em ${HOME}/bin. Depois de instalar a CLI, você pode adicionar o diretório ${HOME}/bin à variável de ambiente PATH em seu perfil.

if [[ -d ${HOME}/bin ]]; then
  export PATH=${HOME}/bin:$PATH
fi

Instalação da CLI do CycleCloud para Windows

No Windows Explorer, copie o arquivo zip do instalador da CLI para um diretório temporário, como Downloads ou $env:TMP. Clique com o botão direito do mouse na cópia de cyclecloud-cli.zip e selecione Extrair Tudo. Essa ação cria uma subpasta chamada cyclecloud-cli-installer-<VERSION>.

cyclecloud-cli-installer-<VERSION> Na subpasta, você encontra um script do PowerShell chamado install.ps1. Clique duas vezes no script install.ps1 para concluir a instalação da CLI.

Agora, a CLI do CycleCloud está disponível no PATH do sistema para novas sessões de Prompt de Comando ou PowerShell.

Inicializar a CLI do CycleCloud

Depois de instalar a CLI, conecte-a ao servidor do Azure CycleCloud. A CLI do Azure CycleCloud usa uma API REST para se comunicar com o servidor. Você precisa inicializá-lo com a URL do servidor do Azure CycleCloud:

1. Execute cyclecloud initialize para configurar o servidor. Você será solicitado a solicitar a URL do CycleServer, que é o FQDN do servidor de aplicativos. Insira-o no formato https://FQDN.
2. O servidor instalado do Azure CycleCloud usa um certificado SSL Let's Encrypt ou um certificado autoassinado. Digite yes quando solicitado a permitir o certificado.
3. Entre com o mesmo nome de usuário e senha que você usa para a interface da Web do CycleCloud.
4. Execute cyclecloud show_cluster para testar se a CLI do CycleCloud está funcionando.

Leitura adicional

• Referência da CLI do CycleCloud