Todos os produtos
Search
Central de documentação

Simple Log Service:Instalar o CLI

Última atualização: Jul 03, 2026

O SLS CLI oferece suporte à maioria dos recursos do SLS, incluindo gerenciamento de projetos e Logstores, consultas de log, paginação automática e replicação geográfica entre contas.

Antes de começar

O SLS CLI requer Python. Baixe-o no site oficial do Python.

Item

Descrição

Versão atual do CLI

0.2.9

Nota

Execute o comando de instalação para atualizar. Utilize sempre a versão mais recente.

Código-fonte

Aliyun Log CLI

Versões compatíveis do Python

  • Python 2: 2,7 ou posterior

  • Python 3: 3,7 ou posterior

Sistemas operacionais suportados

Windows, Linux e macOS.

Componentes dependentes

Após instalar o Python, instale estas dependências com pip install package_name:

  • docopt

  • aliyun-log-python-sdk

  • jmespath

  • aliyun-python-sdk-core

  • aliyun-python-sdk-sts

  • requests

Etapa 1: Configurar variáveis de ambiente do Python

Importante

Configure as variáveis de ambiente para garantir que os comandos aliyunlog funcionem corretamente. Após a configuração, talvez seja necessário reiniciar suas IDEs ou serviços para que as alterações tenham efeito.

Configurar variáveis de ambiente do Python no Linux e macOS

  1. Crie o arquivo .bash_profile.

    Nota

    Se esta for a primeira vez que você define variáveis de ambiente, execute touch ~/.bash_profile para criar o arquivo. Caso ele já exista, execute vim ~/.bash_profile para editá-lo.

    touch ~/.bash_profile
    vim ~/.bash_profile
  2. Visualize o diretório de instalação do Python.

    which python3
  3. Configure o arquivo .bash_profile.

    export PATH=$PATH:/usr/local/python3/bin
  4. Aplique as configurações do arquivo .bash_profile.

    # Make the configuration file take effect.
    source ~/.bash_profile

Configurar variáveis de ambiente do Python no Windows

Defina as variáveis de ambiente na interface gráfica do Windows 10:

  1. Localize o caminho de instalação do Python.

    Na área de trabalho, clique em com o botão direito em This PC e selecione > Path para encontrar a variável de ambiente do Python.

  2. Adicione a variável de ambiente do Python.

    Na área de trabalho, clique em com o botão direito em This PC e selecione > Path > Create. Por exemplo, se a variável encontrada na Etapa 1 for D:\dev\python\python37\, a variável a ser adicionada é D:\dev\python\python37\bin.

Etapa 2: Instalar o CLI

Instalar o CLI no Linux

  1. Faça login em um servidor Linux.

  2. Instale o CLI:

    pip3 install aliyun-log-python-sdk aliyun-log-cli -U --no-cache
  3. Verifique a instalação.

    Execute o seguinte comando:

    aliyunlog --version

    Uma saída bem-sucedida confirma a instalação.

Instalar o CLI no Windows

  1. Faça login em um servidor Windows.

  2. Abra o prompt de comando.

    Se a variável de ambiente do Python estiver definida, prossiga para a próxima etapa. Caso o pip3 não seja encontrado, navegue até o caminho de instalação do Python com cd antes de executar o comando de instalação.

  3. Instale o CLI:

    pip3 install aliyun-log-python-sdk aliyun-log-cli -U --no-cache
  4. Verifique a instalação.

    Execute o seguinte comando:

    aliyunlog --version

    Uma saída bem-sucedida confirma a instalação.

Instalar o CLI no macOS

Instale o SLS CLI com pip3:

pip3 install -U aliyun-log-cli --no-cache

Atualizar o CLI

Execute novamente o comando de instalação para atualizar para a versão mais recente.

Desinstalar o CLI

Para desinstalar o CLI:

pip3 uninstall aliyun-log-cli

Perguntas frequentes

A versão padrão do Python em uma instância ECS Linux é 3,6. Como atualizo o Python para 3,7 ou posterior?

Não desinstale o Python padrão no ECS. Em vez disso, modifique o link simbólico ou utilize uma ferramenta de gerenciamento de múltiplas versões.

  • Modificar o link simbólico

    1. Instale uma versão mais recente do Python. Instalar Python usando um gerenciador de pacotes.

    2. Execute which python3 para localizar o caminho de instalação, por exemplo /usr/bin/python3.

    3. Modifique o link simbólico.

      sudo which python3 pip3
      rm -rf /usr/bin/python3 /usr/bin/pip3
      
      # Add a symbolic link. /usr/bin/python3.11 is the installation path of the later version.
      sudo ln -s /usr/bin/python3.11 /usr/bin/python3
      sudo ln -s /usr/bin/pip3.11 /usr/bin/pip3
    4. Execute python -V para verificar a alteração.

  • Ferramenta de gerenciamento de múltiplas versões