As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Instale oSession Manager plugin para oAWS CLI
Para usar oAWS Command Line Interface (AWS CLI) para iniciar sessões com seus nós gerenciados, primeiro será necessário instalar o Session Managerplugin em sua máquina local. Você pode instalar o plugin em versões com suporte do Microsoft WindowsmacOS, Linux e Ubuntu.
Sempre use a versão mais recente doSession Manager plugin
Ocasionalmente, atualizamos oSession Manager plug-in com funcionalidades novas ou aprimoradas. Portanto, recomendamos instalar sempre a versão mais recente. Para obter mais informações, consulte Versão mais recente e histórico de lançamentos do plugin Session Manager.
Instale aAWS CLI versão necessária
Para usar oSession Manager plugin, será necessário instalarAWS CLI a aplicação da aplicação da aplicação do plugin em sua máquina local.
Tópicos
- Instalar o plugin do Session Manager no Windows
- Instalar e desinstalar o plugin do Session Manager no macOS.
- Instale o plugin Session Manager no macOS usando o instalador assinado.
- Instalar oSession Manager plugin emLinux
- Instale o plugin Session Manager no Ubuntu Server
- Verifique a instalação do plugin do Session Manager
- Session Managerplugin ativado GitHub
- (Opcional) Ative o plugin de registro em log do Session Manager
- Versão mais recente e histórico de lançamentos do plugin Session Manager
Instalar o plugin do Session Manager no Windows
Você pode instalar oSession Manager plugin emWindows Vista ou posteriormente usando o instalador independente.
Quando as atualizações são lançadas, repita o processo de instalação para instalar a versão mais recente do plugin do Session Manager.
nota
Para obter melhores resultados, recomendamos iniciar sessões emWindows clientes usando a aplicação da aplicação da aplicação da aplicação da aplicação da aplicação daWindows PowerShell aplicação da aplicação da aplicação da aplicação da. É possível também usar o shell de comando emWindows 10. OSession Manager plugin é compatívelPowerShell apenas com o shell de comando. Ferramentas da linha de comando de terceiros podem não ser compatíveis com o plugin.
Para instalar o plugin do Session Manager usando o instalador EXE
-
Baixe o instalador usando a seguinte URL:
https://s3.amazonaws.com/session-manager-downloads/plugin/latest/windows/SessionManagerPluginSetup.exe
Como alternativa, você pode baixar uma versão compactada do instalador usando o seguinte URL:
https://s3.amazonaws.com/session-manager-downloads/plugin/latest/windows/SessionManagerPlugin.zip
-
Execute o instalador baixado e siga as instruções na tela. Se você baixou a versão compactada do instalador, você deve descompactar o instalador primeiro.
Deixe a caixa do local de instalação em branco para instalar o plugin no diretório padrão.
-
%PROGRAMFILES%\Amazon\SessionManagerPlugin\bin\
-
-
Verifique se a instalação foi bem-sucedida. Para obter mais informações, consulte Verifique a instalação do plugin do Session Manager.
nota
SeWindows não conseguir encontrar o executável, talvez seja necessário reabrir o prompt de comando ou adicionar o diretório de instalação à sua variável de
PATH
ambiente manualmente. Para obter informações, consulte o tópico sobre solução de problemas Session Managerplugin não é adicionado automaticamente ao caminho de linha de comando (Windows).
Instalar e desinstalar o plugin do Session Manager no macOS.
Você pode instalar o plugin Session Manager no macOS usando o instalador integrado.
Importante
O pacote de instalador fornecido não é compatível com a instalação em caminhos com espaços.
Para instalar o plugin Session Manager usando o pacote de instalador (macOS)
-
Baixe o instalador em pacote.
-
Descompacte o pacote.
unzip sessionmanager-bundle.zip
-
Execute o comando de instalação.
sudo ./sessionmanager-bundle/install -i /usr/local/sessionmanagerplugin -b /usr/local/bin/session-manager-plugin
nota
O plugin exige Python 2.6.5 ou posterior ou Python 3.3 ou posterior. Por padrão, o script de instalação é executado sob a versão padrão do sistema do Python. Se uma versão diferente do Python estiver instalada, mas deseja usá-la para instalar o plugin do Session Manager, execute o script de instalação com essa versão por caminho absoluto para o Python executável. Veja um exemplo a seguir.
sudo /usr/local/bin/python3.6 sessionmanager-bundle/install -i /usr/local/sessionmanagerplugin -b /usr/local/bin/session-manager-plugin
O instalador instala o plugin do Session Manager em
/usr/local/sessionmanagerplugin
e cria o symlinksession-manager-plugin
no diretório/usr/local/bin
. Isso elimina a necessidade de especificar o diretório de instalação na variável$PATH
do usuário.Para ver uma explicação das opções
-i
e-b
, use a opção-h
../sessionmanager-bundle/install -h
-
Verifique se a instalação foi bem-sucedida. Para obter mais informações, consulte Verifique a instalação do plugin do Session Manager.
nota
Para desinstalar o plugin, execute os comandos a seguir, um de cada vez.
sudo rm -rf /usr/local/sessionmanagerplugin
sudo rm /usr/local/bin/session-manager-plugin
Instale o plugin Session Manager no macOS usando o instalador assinado.
Você pode instalar o plugin Session Manager no macOS usando o instalador assinado.
Para instalar o plugin do Session Manager usando o instalador assinado (macOS)
-
Baixe o instalador assinado.
-
Execute os comandos de instalação.
sudo installer -pkg session-manager-plugin.pkg -target / sudo ln -s /usr/local/sessionmanagerplugin/bin/session-manager-plugin /usr/local/bin/session-manager-plugin
-
Verifique se a instalação foi bem-sucedida. Para obter mais informações, consulte Verifique a instalação do plugin do Session Manager.
Instalar oSession Manager plugin emLinux
-
Baixe e instale o pacote RPM doSession Manager plugin.
-
Verifique se a instalação foi bem-sucedida. Para obter mais informações, consulte Verifique a instalação do plugin do Session Manager.
nota
Se você não deseja desinstalar o plugin, execute sudo yum erase
session-manager-plugin -y
Instale o plugin Session Manager no Ubuntu Server
-
Baixe o pacote deb do plugin do Session Manager:
-
Execute o comando de instalação.
sudo dpkg -i session-manager-plugin.deb
-
Verifique se a instalação foi bem-sucedida. Para obter mais informações, consulte Verifique a instalação do plugin do Session Manager.
nota
Se você não deseja desinstalar o plugin, execute sudo dpkg -r
session-manager-plugin
Verifique a instalação do plugin do Session Manager
Execute os comandos a seguir para verificar se a instalação do plugin do Session Manager foi bem-sucedida.
session-manager-plugin
Se a instalação foi bem-sucedida, a mensagem a seguir é retornada.
The Session Manager plugin is installed successfully. Use the AWS CLI to start a session.
Você também pode testar a instalação executando o seguinte comando no AWS CLI. No comando a seguir, substitua instance-id
por suas próprias informações.
aws ssm start-session --target
instance-id
Esse comando funcionará somente se o administrador do Session Manager tiver concedido as permissões do IAM necessárias para acessar o nó gerenciado de destino usando Session Manager.
Session Managerplugin ativado GitHub
O código-fonte doSession Manager plugin está disponível em GitHub
(Opcional) Ative o plugin de registro em log do Session Manager
O plugin do Session Manager inclui uma opção para permitir o registro em log para sessões que você executar. Por padrão, o registro em log está desativado.
Se você permitir o registro em log, o plugin Session Manager criará arquivos de log para ambas as atividades (session-manager-plugin.log
) e erros (errors.log
) da aplicação em sua máquina local.
Tópicos
Ativar o registro doSession Manager plugin (Windows)
-
Localize o arquivo
seelog.xml.template
para o plugin.O local padrão é
C:\Program Files\Amazon\SessionManagerPlugin\seelog.xml.template
. -
Altere o nome do arquivo para
seelog.xml
. -
Abra o arquivo e altere
minlevel="off"
paraminlevel="info"
ouminlevel="debug"
.nota
Por padrão, as entradas de log sobre como abrir um canal de dados e reconectar sessões são registrados no nível INFO. As entradas de fluxo de dados (pacotes e confirmação) são registradas no nível DEBUG.
-
Altere outras opções de configuração as quais deseja modificar. As opções que você pode alterar incluem:
-
Depurar nível: você pode alterar o nível de depuração de
formatid="fmtinfo"
paraoutputs formatid="fmtdebug"
. -
Opções de arquivo de log: você pode fazer alterações nas opções de arquivo de log, incluindo onde os logs são armazenados, com exceção dos nomes dos arquivos.
Importante
Não altere os nomes de arquivos ou o registro não funcionará corretamente.
<rollingfile type="size" filename="C:\Program Files\Amazon\SessionManagerPlugin\Logs\session-manager-plugin.log" maxsize="30000000" maxrolls="5"/> <filter levels="error,critical" formatid="fmterror"> <rollingfile type="size" filename="C:\Program Files\Amazon\SessionManagerPlugin\Logs\errors.log" maxsize="10000000" maxrolls="5"/>
-
-
Salve o arquivo.
Habilitar o registro para oSession Manager plug-in (LinuxemacOS)
-
Localize o arquivo
seelog.xml.template
para o plugin.O local padrão é
/usr/local/sessionmanagerplugin/seelog.xml.template
. -
Altere o nome do arquivo para
seelog.xml
. -
Abra o arquivo e altere
minlevel="off"
paraminlevel="info"
ouminlevel="debug"
.nota
Por padrão, as entradas de log sobre como abrir canais de dados e reconectar sessões são registrados no nível INFO. As entradas de fluxo de dados (pacotes e confirmação) são registradas no nível DEBUG.
-
Altere outras opções de configuração as quais deseja modificar. As opções que você pode alterar incluem:
-
Depurar nível: você pode alterar o nível de depuração de
formatid="fmtinfo"
paraoutputs formatid="fmtdebug"
-
Opções de arquivo de log: você pode fazer alterações nas opções de arquivo de log, incluindo onde os logs são armazenados, com exceção dos nomes dos arquivos.
Importante
Não altere os nomes de arquivos ou o registro não funcionará corretamente.
<rollingfile type="size" filename="/usr/local/sessionmanagerplugin/logs/session-manager-plugin.log" maxsize="30000000" maxrolls="5"/> <filter levels="error,critical" formatid="fmterror"> <rollingfile type="size" filename="/usr/local/sessionmanagerplugin/logs/errors.log" maxsize="10000000" maxrolls="5"/>
Importante
Se você usar o diretório padrão para armazenar logs, você deve executar comandos de sessão usando sudo ou atribuir o diretório onde o plugin está instalado permissões totais de leitura e gravação. Para ignorar essas restrições, altere o local onde os logs são armazenados.
-
-
Salve o arquivo.
Versão mais recente e histórico de lançamentos do plugin Session Manager
Suas máquinas locais devem estar executando uma versão com suporte para o plugin Session Manager. A versão mínima compatível atual é 1.1.17.0. Se você estiver executando uma versão anterior, as operações do Session Manager podem não ser bem-sucedidas.
Para ver se você tem a versão mais recente, execute o seguinte comando no AWS CLI.
nota
O comando retornará resultados somente se o plugin estiver localizado no diretório de instalação padrão do tipo de sistema operacional. Você também pode verificar a versão no conteúdo do arquivo do VERSION
no diretório onde você instalou o plugin.
session-manager-plugin --version
A tabela a seguir lista todas as versões do plugin do Session Manager, bem como os recursos e aprimoramentos incluídos em cada versão.
Versão | Data de lançamento | Detalhes |
---|---|---|
1.2.463,0 |
15 de março de 2023 |
Aprimoramento: Foi adicionado suporte a ARM64 para Apple Mac (M1) no instalador do pacote macOS e no instalador assinado. |
1.2.398.0 |
14 de outubro de 2022 |
Aprimoramento: compatibilidade com a versão 1.17 do golang. Atualizar o session-manager-plugin programa de execução padrão para macOS para usar o python3. Atualizar o caminho de importação de SSMCLI para session-manager-plugin. |
1.2.339,0 |
16 de junho de 2022 |
Correção de bug: corrigir o tempo limite da sessão ociosa para sessões de porta. |
1.2.331.0 |
27 de maio de 2022 |
Correção de bug: corrigir sessões de porta fechando prematuramente quando o servidor local não se conecta antes do tempo limite se esgotar. |
1.2.323,0 |
19 de maio de 2022 |
Correção de bug: desativar o smux keep live para usar o recurso de tempo limite de sessão ociosa. |
1.2.312.0 |
31 de março de 2022 |
Aprimoramento: Suporta mais tipos de carga útil de mensagem de saída. |
1.2.295,0 |
12 de janeiro de 2022 |
Correção de bugs: sessões suspensas causadas pelo reenvio de dados de fluxo do cliente quando o agente se torna inativo e registros incorretos de mensagens start_publication e pause_publication . |
1.2.279,0 |
27 de outubro de 2021 |
Aprimoramento: empacotamento em zip para aWindows plataforma. |
1.2.245.0 |
19 de agosto de 2021 |
Melhoria: atualize o aws-sdk-go para a versão mais recente (v1.40.17) para suporte a AWS IAM Identity Center (successor to AWS Single Sign-On). |
1.2.234.0 |
26 de julho de 2021 |
Correção de bugs: administre o encerramento abrupto da sessão no tipo de sessão interativa. |
1.2.205.0 |
10 de junho de 2021 |
Melhoria: adição de suporte para o instalador do macOS |
1.2.54.0 |
29 de janeiro de 2021 |
Aprimoramento: inclusão do suporte para execução de sessões em modo NonInteractiveCommands de execução. |
1.2.30.0 |
24 de novembro de 2020 |
Melhoria: (somente sessões de encaminhamento de porta) melhoria geral da performance. |
1.2.7.0 |
15 de outubro de 2020 |
Melhoria: (somente sessões de encaminhamento de porta) latência reduzida e melhoria geral da performance. |
1.1.61.0 |
17 de abril de 2020 |
Aprimoramento: adição de suporte a ARM para Linux e Ubuntu Server. |
1.1.54.0 |
6 de janeiro de 2020 |
Correção de erros: administre a condição de disputa dos pacotes que estão sendo descartados quando o plugin Session Manager ainda não estiver pronto. |
1.1.50.0 |
19 de novembro de 2019 |
Melhoria: adição de suporte para encaminhar uma porta para um soquete unix local. |
1.1.35.0 |
7 de novembro de 2019 |
Aprimoramento: (Somente sessões de encaminhamento de portas) Envie um TerminateSession comando paraSSM Agent quando o usuário local pressionar |
1.1.33.0 | 26 de setembro de 2019 | Melhoria: (somente sessões de encaminhamento de porta) envio de um sinal de desconexão para o servidor quando o cliente interromper a conexão TCP. |
1.1.31.0 | 6 de setembro de 2019 | Melhoria: atualização para manter a sessão de encaminhamento de porta aberta até que o servidor remoto encerre a conexão. |
1.1.26.0 |
30 de julho de 2019 |
Melhoria: atualização para limitar a throughput de dados durante uma sessão. |
1.1.23.0 |
9 de julho de 2019 |
Melhoria: adição de suporte à execução de sessões SSH usando o Session Manager. |
1.1.17.0 | 4 de abril de 2019 |
Melhoria: adição de suporte para a criptografia adicional de dados da sessão usando o AWS Key Management Service (AWS KMS). |
1.0.37.0 | 20 de setembro de 2018 |
Aprimoramento: correção de bug para aWindows versão. |
1.0.0.0 | 11 de setembro de 2018 |
Versão inicial do plugin do Session Manager. |