Skip to main content

Download e instalação

Objetivo​

Este tópico descreve como instalar ou atualizar a versão mais recente da MGC CLI em sistemas operacionais compatíveis. Para obter informações sobre as versões mais recentes, consulte as releases no Github.

Como fazer​

Homebrew

Recomendamos a instalação através da ferramenta Homebrew, pois ela facilita a atualização da CLI e garante que todas as dependências necessárias estejam instaladas e será mais fácil manter a CLI atualizada.

  1. Se não tiver o brew instalado, instale no seu macOS.

    a. Para obter informações sobre a instalação, consulte Homebrew.

    b. Para verificar se o brew está instalado corretamente, execute o seguinte comando.

    brew --version
    info

    Se o comando retornar um erro como command not found: brew, o Homebrew pode estar instalado, mas o diretório dele não está configurado na variável PATH.

  2. Execute o comando de instalação.

    brew install magalucloud/mgc/mgccli

  3. Para verificar se a instalação foi concluída com sucesso, execute o comando abaixo. Ele deve retornar a versão instalada da CLI.

    mgc --version

  4. Quando uma nova versão for publicada, atualize a CLI com o comando abaixo.

    brew update && brew upgrade mgccli
Arquivo tar.gz
info

Tenha certeza de que seu usuário possui permissão sudo.

  1. A CLI possui arquivos de instalação separados para cada arquitetura. Baixe o arquivo correspondente a sua arquitetura no repositório oficial.

  2. Abra um terminal e execute o seguinte comando para criar um diretório dedicado a CLI na sua home de usuário.

    mkdir ~/mgc_cli

  3. Execute o comando abaixo no mesmo diretório onde está o arquivo .tar.gz. Atualize o nome do arquivo de acordo com aquele que você baixou.

    tar -xvf mgccli_x.xx.x_darwin_amd64.tar.gz -C ~/mgc_cli

  4. Para melhor experiência com a CLI, recomendamos adicionar o diretório de instalação à variável PATH. Execute o comando abaixo para aplicar na sessão atual e adicione a mesma linha ao arquivo ~/.bashrc ou ~/.zshrc, dependendo do seu shell, para que a configuração seja permanente.

    export PATH=$HOME/mgc_cli:$PATH
Atenção

Será necessário dar permissão de execução ao binário. Na primeira vez que você executá-lo no terminal, o macOS exibirá um alerta. Ignore o alerta e vá até "Configurações do Sistema", na aba "Privacidade e Segurança". Lá você deverá confirmar que aceita a execução do binário "mgc".

  1. Para verificar se a instalação foi concluída com sucesso, execute o comando abaixo. Ele deve retornar a versão instalada da CLI.

    mgc --version

  2. Quando uma nova versão for publicada, baixe o novo arquivo .tar.gz no repositório oficial e repita o passo 3, extraindo o conteúdo no mesmo diretório ~/mgc_cli para substituir a versão anterior. Em seguida, execute mgc --version novamente para confirmar a atualização.

Snap

O Snap é a forma mais simples de instalar a CLI no Linux e funciona na maioria das distribuições.

  1. Se não tiver o snap instalado, instale na sua distribuição.

    a. Para obter informações sobre a instalação, consulte Snapcraft.

    b. Para verificar se o snap está instalado corretamente, execute o seguinte comando.

    snap --version

  2. Execute o comando de instalação.

    sudo snap install mgccli

  3. Para verificar se a instalação foi concluída com sucesso, execute o comando abaixo. Ele deve retornar a versão instalada da CLI.

    mgc --version

  4. A atualização da CLI é feita automaticamente pelo Snap. Para forçar a atualização manualmente, execute o comando abaixo.

    sudo snap refresh mgccli
APT

Disponível para distribuições baseadas em Debian, como o Ubuntu. Este método integra a CLI ao sistema de atualizações automáticas da distribuição.

  1. Faça o download da chave de verificação do repositório.

    sudo gpg --yes --keyserver keyserver.ubuntu.com --recv-keys 0C59E21A5CB00594 && sudo gpg --export --armor 0C59E21A5CB00594 | sudo gpg --dearmor -o /etc/apt/keyrings/magalu-archive-keyring.gpg

  2. Adicione o repositório da Magalu Cloud à lista de repositórios do sistema.

    echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/magalu-archive-keyring.gpg] https://packages.magalu.cloud/apt stable main" | sudo tee /etc/apt/sources.list.d/magalu.list

  3. Atualize a lista de pacotes e execute o comando de instalação.

    sudo apt update
    sudo apt install mgccli

  4. Para verificar se a instalação foi concluída com sucesso, execute o comando abaixo. Ele deve retornar a versão instalada da CLI.

    mgc --version

  5. Quando uma nova versão for publicada, atualize a CLI com o comando abaixo.

    sudo apt update && sudo apt upgrade mgccli
Pacote .deb

Disponível para distribuições baseadas em Debian, como o Ubuntu.

  1. Baixe o pacote .deb correspondente a sua arquitetura no repositório oficial.

  2. Execute o comando abaixo em um terminal dentro do diretório onde está o pacote. Atualize o nome do arquivo .deb de acordo com aquele que você baixou.

    sudo dpkg -i mgccli_x.xx.x_linux_amd64.deb

  3. Para verificar se a instalação foi concluída com sucesso, execute o comando abaixo. Ele deve retornar a versão instalada da CLI.

    mgc --version

  4. Quando uma nova versão for publicada, baixe o novo pacote .deb no repositório oficial e repita o passo 2 para instalar a nova versão sobre a anterior.

Pacote .rpm

Disponível para distribuições baseadas em Red Hat, como o Fedora e o CentOS.

  1. Baixe o pacote .rpm correspondente a sua arquitetura no repositório oficial.

  2. Execute o comando abaixo no mesmo diretório onde está o pacote. Atualize o nome do arquivo .rpm de acordo com aquele que você baixou.

    sudo rpm -i mgccli_x.xx.x_linux_amd64.rpm

  3. Para verificar se a instalação foi concluída com sucesso, execute o comando abaixo. Ele deve retornar a versão instalada da CLI.

    mgc --version

  4. Quando uma nova versão for publicada, baixe o novo pacote .rpm no repositório oficial e execute o comando abaixo para atualizar.

    sudo rpm -U mgccli_x.xx.x_linux_amd64.rpm
Arquivo tar.gz
info

Tenha certeza de que seu usuário possui permissão sudo.

  1. A CLI possui arquivos de instalação separados para cada arquitetura. Baixe o arquivo correspondente a sua arquitetura no repositório oficial.

  2. Abra um terminal e execute o seguinte comando para criar um diretório dedicado a CLI na sua home de usuário.

    mkdir ~/mgc_cli

  3. Execute o comando abaixo no mesmo diretório onde está o arquivo .tar.gz. Atualize o nome do arquivo de acordo com aquele que você baixou.

    tar -xvf mgccli_x.xx.x_linux_amd64.tar.gz -C ~/mgc_cli

  4. Para melhor experiência com a CLI, recomendamos adicionar o diretório de instalação à variável PATH. Execute o comando abaixo para aplicar na sessão atual e adicione a mesma linha ao arquivo ~/.bashrc ou ~/.zshrc, dependendo do seu shell, para que a configuração seja permanente.

    export PATH=$HOME/mgc_cli:$PATH

  5. Para verificar se a instalação foi concluída com sucesso, execute o comando abaixo. Ele deve retornar a versão instalada da CLI.

    mgc --version

  6. Quando uma nova versão for publicada, baixe o novo arquivo .tar.gz no repositório oficial e repita o passo 3, extraindo o conteúdo no mesmo diretório ~/mgc_cli para substituir a versão anterior.

Pré-requisitos
  • Windows 10 ou 11.
  • Ser capaz de extrair ou "descompactar" o arquivo ZIP baixado. O Windows já inclui essa funcionalidade no Explorador de Arquivos; se preferir, use um equivalente.

  1. A CLI possui arquivos de instalação separados para cada arquitetura. Baixe o arquivo correspondente a sua arquitetura (amd64 / arm64) no repositório oficial.

  2. Extraia o arquivo ZIP em uma pasta de sua preferência. Nos comandos a seguir, consideramos que os arquivos foram extraídos em C:\mgc. Atualize o caminho de acordo com a pasta que você escolheu.

  3. Abra o PowerShell e navegue até a pasta onde você extraiu os arquivos.

    cd C:\mgc

  4. Para melhor experiência com a CLI, recomendamos adicionar o diretório de instalação à variável de ambiente PATH. Execute o comando abaixo para aplicar na sessão atual.

    $env:Path += ";C:\mgc"

  5. Para que a configuração seja permanente, execute o comando abaixo. Ele adiciona o diretório à variável PATH do seu usuário, sem alterar a variável de ambiente do sistema.

    [Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";C:\mgc", "User")

  6. Para verificar se a instalação foi concluída com sucesso, execute o comando abaixo. Ele deve retornar a versão instalada da CLI.

    mgc --version

  7. Quando uma nova versão for publicada, baixe o novo arquivo ZIP no repositório oficial e repita o passo 2, extraindo o conteúdo na mesma pasta para substituir a versão anterior. Em seguida, execute mgc --version novamente para confirmar a atualização.

Solução de problemas na instalação​

Se você encontrar problemas após instalar a MGC CLI, consulte os tópicos de solução de problemas abaixo:

Perguntas frequentes​

Qual método de instalação devo escolher? Sempre que possível, prefira os métodos que usam um gerenciador de pacotes: Homebrew no macOS, Snap ou repositório APT no Linux. Eles cuidam das dependências e permitem atualizar a CLI com um único comando. Os pacotes .deb e .rpm, o arquivo tar.gz e o arquivo ZIP exigem que você baixe e substitua os arquivos manualmente a cada nova versão.

Como descubro a arquitetura do meu sistema? No macOS e no Linux, execute uname -m em um terminal: x86_64 corresponde aos arquivos amd64 e aarch64 ou arm64 corresponde aos arquivos arm64. No Windows, execute echo $env:PROCESSOR_ARCHITECTURE no PowerShell: o retorno AMD64 corresponde aos arquivos amd64 e ARM64 aos arquivos arm64.

Posso instalar uma versão específica da CLI? Sim. Todas as versões ficam disponíveis no repositório oficial: basta baixar os arquivos da versão desejada e seguir as instruções do método correspondente.

A CLI funciona no WSL? Sim. No Windows Subsystem for Linux, use as instruções da aba Linux, de acordo com a distribuição instalada.

Próximos passos​