Download e instalação
MacOS
Para instalar a CLI no seu sistema macOS, você pode escolher entre a instalação via Homebrew ou baixar o arquivo tar.gz. 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.
Homebrew
Para instalar a CLI utilizar a ferramenta brew, você precisa ter certeza de que ela está corretamente instalada no seu sistema. Visite o site oficial: Homebrew
Depois abra um terminal e execute o comando de instalação:
brew install magalucloud/mgc/mgccli
Arquivo tar.gz
A CLI possui arquivos de instalação separados para cada arquitetura. Baixe o arquivo correspondente a sua arquitetura no repositório oficial.
https://github.com/MagaluCloud/mgccli/releases/
Tenha certeza de que seu usuário possui permissão sudo.
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
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 mgc_0.18.3_linux_amd64.tar.gz -C ~/mgc_cli
Para melhor experiência com a CLI, recomendamos que o diretório de instalação seja adicionado na variável PATH. Rode o comando abaixo e depois adicione essa linha ao arquivo ~/.bashrc ou ~/.zshrc dependendo do seu shell.
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".
Linux
Disponibilizamos pacotes .deb e .rpm para instalação em sistemas baseados em Debian e Red Hat, um repositório APT para integração ao sistema de atualizações automáticas de distribuições Debian/Ubuntu, além do arquivo tar.gz para instalação manual.
Debian / Ubuntu
Para instalar via APT, execute os comandos abaixo:
# Download da chave de verificação
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
# Adiciona repositório APT na lista de repositórios
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
# Instala a MGC CLI
sudo apt update
sudo apt install mgccli
Para instalar a CLI apartir do pacote deb, basta executar 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 mgc_x.xx.x_linux_amd64.deb
Fedora / CentOS
Para instalar a CLI apartir do pacote rpm, basta executar 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 mgc_x.xx.x_linux_amd64.rpm
Arquivo tar.gz
A CLI possui arquivos de instalação separados para cada arquitetura. Baixe o arquivo correspondente a sua arquitetura no repositório oficial.
https://github.com/MagaluCloud/mgccli/releases/
Tenha certeza de que seu usuário possui permissão sudo.
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
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 mgc_0.18.3_linux_amd64.tar.gz -C ~/mgc_cli
Para melhor experiência com a CLI, recomendamos que o diretório de instalação seja adicionado na variável PATH. Rode o comando abaixo e depois adicione essa linha ao arquivo ~/.bashrc ou ~/.zshrc dependendo do seu shell.
export PATH=$HOME/mgc_cli:$PATH
Windows
A CLI possui arquivos de instalação separados para cada arquitetura. Baixe o arquivo correspondente a sua arquitetura (amd64 / arm) no repositório oficial.
https://github.com/MagaluCloud/mgccli/releases/
Para instalar a CLI no seu sistema Windows 10/11 siga os passos abaixo.
- Realize o download do arquivo ZIP para uma pasta de sua preferência e descompacte o mesmo.
- Abra um Prompt de Comando ou terminal Powershell como administrador e navegue até a pasta onde você extraiu os arquivos, por exemplo: Você salvou a pasta no drive C com o nome de mgc, logo você irá executar o seguinte comando:
C:\mgc> .\mgc.exe
- Após é necessário adicionar a CLI na variável de ambiente PATH, referenciando o local da sua instalação.
Atualize o caminho para o diretório onde você extraiu a CLI e execute o comando abaixo.(Altere a letra da unidade ou caminho conforme o local onde salvou em seu computador)
$env:Path += ";C:\mgc"
- Para adicionar a variável de ambiente PATH de forma persistente execute o comando abaixo ajustando o caminho do arquivo no seu computador.
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\mgc", [EnvironmentVariableTarget]::User)
- Após execute o seguinte comando para confirmar que a configuração foi bem-sucedida:
mgc --version
7.Se o processo tiver sido finalizado com sucesso você receberá uma mensagem informando a versão em uso, conforme abaixo:
PS C:\mgc> mgc --version
C:\mgc\mgc.exe version v0.34.0 (windows/amd64)
8.Execute o comando mgc auth login , ele irá lhe redirecionar para autenticação na console e após isso você poderá seguir utilizando a CLI normalmente.