Instalação manual

Você pode instalar o Azure CycleCloud com um modelo ARM, por meio do Azure Marketplace ou usando um contêiner no Registro de Contêiner do Azure. Recomendamos a instalação com a imagem do Azure Marketplace. No entanto, para algumas situações de produção, a instalação manual do CycleCloud, conforme descrito neste artigo, pode ser útil.

Observação

O produto CycleCloud inclui muitos componentes, como o software de configuração de nó conhecido como Jetpack e uma plataforma de servidor web instalável chamada CycleServer. Devido a essa arquitetura, você vê referências ao CycleServer em muitos comandos e nomes de diretório na máquina onde você instala o servidor CycleCloud.

Requisitos do sistema

Para instalar o CycleCloud, você deve ter direitos de administrador (root). Além disso, seu sistema precisa atender aos seguintes requisitos mínimos:

  • Uma distribuição Linux de 64 bits
  • Java Runtime Environment (versão 8)
  • Pelo menos 8 GB de RAM (16 GB recomendado)
  • Quatro ou mais núcleos de CPU
  • Pelo menos 250 GB de espaço livre em disco

Observação

Você pode instalar o CycleCloud em hardware físico ou virtualizado.

Chave SSH

A chave SSH padrão usada no CycleCloud é /opt/cycle_server/.ssh/cyclecloud.pem. Se essa chave ainda não existir, o CycleCloud a gerará automaticamente quando for iniciada (ou reiniciada).

Instalação

Para determinar sua distribuição Linux, execute o seguinte comando:

cat /etc/lsb-release

Se o ficheiro /etc/os-release existir, o seu conteúdo indica se a sua distribuição é baseada em Debian, como o Ubuntu. Se o arquivo não existir, execute este comando:

cat /etc/redhat-release

Se o /etc/redhat-release arquivo existir, seu conteúdo mostrará se sua distribuição é baseada em Enterprise-Linux, como RedHat Enterprise Linux ou Alma Linux.

Instalando no Debian ou Ubuntu

Primeiro, baixe a chave de assinatura da Microsoft e adicione-a ao chaveiro confiável do Apt:

sudo apt update && sudo apt -y install curl gnupg2
sudo mkdir -m 0755 -p /etc/apt/keyrings
curl -fsSL https://packages.microsoft.com/keys/microsoft.asc |
  gpg --dearmor | sudo tee /etc/apt/keyrings/microsoft.gpg > /dev/null
sudo chmod go+r /etc/apt/keyrings/microsoft.gpg

Em seguida, configure o Apt para extrair do repositório do CycleCloud:

echo "deb [signed-by=/etc/apt/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/cyclecloud stable main" |
  sudo tee /etc/apt/sources.list.d/cyclecloud.list > /dev/null
sudo apt update 

Finalmente, instale o CycleCloud com apt:

sudo apt -y install cyclecloud
sudo apt -y install cyclecloud8

Observação

A versão de distribuição do repositório CycleCloud Apt para a plataforma da família Ubuntu usa um apelido flutuante "estável". CycleCloud suporta oficialmente todas as versões do Ubuntu LTS que a Canonical suporta. Os arquivos do pacote CycleCloud não visam uma versão específica da GLIBC (GNU C Library) ou da versão do Ubuntu.

Instalação em clones do Enterprise Linux (RHEL)

Primeiro, configure um ficheiro cyclecloud.repo:

cat | sudo tee /etc/yum.repos.d/cyclecloud.repo > /dev/null <<EOF
[cyclecloud]
name=cyclecloud
baseurl=https://packages.microsoft.com/yumrepos/cyclecloud
gpgcheck=1
gpgkey=https://packages.microsoft.com/keys/microsoft.asc
EOF

Finalmente, instale cyclecloud com yum (ou dnf):

sudo yum -y install cyclecloud
sudo yum -y install cyclecloud8

Instalação a partir do Centro de Download da Microsoft

Transfira o ficheiro de instalação do Azure CycleCloud a partir do Centro de Transferências da Microsoft e instale-o utilizando um gestor de pacotes.

Para o ficheiro de instalação .rpm:

yum install <filename.rpm>

Para o arquivo de instalação .deb:

dpkg -i <filename.deb>

Observação

Você deve ter permissão de gravação para o diretório /opt. O instalador do CycleCloud cria um usuário e um cycle_server grupo Unix. Ele é instalado no diretório /opt/cycle_server por padrão e atribui cycle_server:cycle_server a propriedade ao diretório.

Quando o instalador terminar de executar, ele fornece um link para concluir a instalação a partir do seu navegador. Copie o link para o navegador da Web e siga as etapas de configuração.

Compilações Insiders

As compilações do CycleCloud Insiders estão disponíveis para testes de recursos de pré-lançamento. As compilações do Programa Insider podem ter problemas por resolver. Nota: as compilações do Insiders não são rotuladas diferentemente das compilações de produção; são apenas candidatos ao lançamento antecipado.

As etapas a seguir adicionam o repositório Insiders para fornecer acesso às compilações do Insiders. Quando você executa esse comando em uma máquina, instalar ou atualizar o pacote obtém a versão mais recente do repositório Insiders. Você não precisa adicionar os repositórios padrão e Insiders porque a compilação mais recente do Insiders é igual ou mais recente do que a compilação padrão mais recente.

Essas instruções mudam para usar apenas compilações do Insiders. Para voltar, siga as instruções de instalação anteriores.

Debian/Ubuntu

Para instalar a compilação Insiders no Debian ou Ubuntu, execute o seguinte comando:

echo "deb [signed-by=/etc/apt/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/cyclecloud insiders main" |
  sudo tee /etc/apt/sources.list.d/cyclecloud.list > /dev/null
sudo apt update 

Este comando é igual aos passos padrão de instalação , mas utiliza o insiders canal em vez disso.

NOTA: Se já configurou anteriormente o seu ficheiro cyclecloud.list com cyclecloud-insiders stable main, deve atualizá-lo para o novo valor cyclecloud insiders main. O repositório antigo foi obsoleto e será eventualmente removido. O seguinte comando pode atualizar um ficheiro de lista previamente criado:

sudo sed -i 's/cyclecloud-insiders stable main/cyclecloud insiders main/' /etc/apt/sources.list.d/cyclecloud.list
sudo apt-get -qq update

Linux Empresarial

Para instalar a compilação do Insiders no Enterprise Linux, execute o seguinte comando:

cat | sudo tee /etc/yum.repos.d/cyclecloud.repo > /dev/null <<EOF
[cyclecloud]
name=cyclecloud
baseurl=https://packages.microsoft.com/yumrepos/cyclecloud-insiders
gpgcheck=1
gpgkey=https://packages.microsoft.com/keys/microsoft.asc
EOF

Este comando é o mesmo que as etapas de instalação padrão , mas usa https://packages.microsoft.com/yumrepos/cyclecloud-insiders/ em vez disso.

Notas sobre segurança

A instalação padrão do CycleCloud usa HTTP não criptografado em execução na porta 8080. É altamente recomendável configurar SSL para todas as instalações.

Não instale o CycleCloud em uma unidade compartilhada ou em qualquer unidade onde usuários não administradores tenham acesso. Qualquer pessoa com acesso ao grupo CycleCloud pode acessar dados não criptografados. Recomendamos que não adicione utilizadores não administradores a este grupo.

Observação

Você pode personalizar a configuração padrão do CycleCloud para ambientes específicos usando as configurações no arquivo $CS_HOME/config/cycle_server.properties.

Configuração

Após a instalação, você pode configurar o CycleCloud através do seu navegador da web. A tela de entrada é carregada depois que o servidor web é totalmente inicializado, o que pode levar vários minutos.

Passo 1: Bem-vindo

tela de boas-vindas

tela de boas-vindas

Insira um Nome do Site e selecione Avançar.

Etapa 2: Contrato de Licença

Tela de Licença

Tela de Licença

Aceite o contrato de licença e selecione Avançar.

Etapa 3: Conta de administrador

Configuração da Conta de Administrador

Configuração da Conta de Administrador

Configure a conta de administrador local para o CycleCloud. Use essa conta para administrar o aplicativo CycleCloud. Não é uma conta de sistema operacional. Introduza um ID de Utilizador, Nome e Palavra-passe e, em seguida, selecione Concluído para continuar.

Observação

Todas as senhas de conta do CycleCloud devem ter entre 8 e 123 caracteres. Devem satisfazer, pelo menos, três das quatro condições seguintes:

  • Conter pelo menos uma letra maiúscula
  • Conter pelo menos uma letra minúscula
  • Conter pelo menos um número
  • Conter pelo menos um caractere especial: @ # $ % ^ & * - _ ! + = [ ] { } | \ : ' , . ?

Passo 4: Defina a sua chave SSH

Depois de configurar sua conta de administrador, defina sua chave pública SSH para que você possa acessar facilmente qualquer máquina Linux iniciada pelo CycleCloud. Para definir sua chave pública SSH, vá para Meu Perfil no menu do usuário no canto superior direito e escolha Editar perfil. Saiba mais sobre como criar chaves SSH aqui.

Atualizar o CycleCloud

Consulte a página de atualização do Azure CycleCloud .