# Executar comandos do EC2Rescue em uma instância do Amazon EC2 no Linux
<a name="ec2rl_working"></a>

O EC2Rescue é uma ferramenta de linha de comandos. Depois de instalar o EC2Rescue em sua instância do Linux, você pode obter ajuda geral sobre como usar a ferramenta executando `./ec2rl help`. Você pode visualizar os módulos disponíveis executando `./ec2rl list` e obter ajuda sobre um módulo específico executando `./ec2rl help module_name`.

Veja a seguir as tarefas comuns que você pode realizar para começar a usar essa ferramenta.

**Topics**
+ [Executar módulos do EC2Rescue](#ec2rl_running_module)
+ [Fazer upload dos resultados do módulo do EC2Rescue](#ec2rl_uploading_results)
+ [Criar backups de uma instância do Amazon EC2 no Linux](#ec2rl_creating_backups)

## Executar módulos do EC2Rescue
<a name="ec2rl_running_module"></a>

**Para executar todos os módulos do EC2Rescue**  
Use o comando **./ec2rl run** sem especificar nenhum parâmetro adicional. Alguns módulos exigem o acesso raiz. Se você não for um usuário-raiz, use **sudo** ao executar o comando.

```
./ec2rl run
```

**Para executar um módulo específico do EC2Rescue**  
Use o comando **./ec2rl run**, e para `--only-modules`, especifique o nome do módulo a ser executado. Alguns módulos exigem *argumentos* para usá-los.

```
./ec2rl run --only-modules=module_name --arguments
```

Por exemplo, para executar o módulo **dig** para consultar o domínio `amazon.com`, use o comando a seguir.

```
./ec2rl run --only-modules=dig --domain=amazon.com
```

**Para exibir os resultados de um módulo do EC2Rescue**  
Execute o módulo e, em seguida, exiba o arquivo de log em `cat /var/tmp/ec2rl/logfile_location`. Por exemplo, o arquivo de log do módulo **dig** pode ser encontrado no seguinte local:

```
cat /var/tmp/ec2rl/timestamp/mod_out/run/dig.log
```

## Fazer upload dos resultados do módulo do EC2Rescue
<a name="ec2rl_uploading_results"></a>

Se o Suporte tiver solicitado os resultados de um módulo do EC2Rescue, você pode fazer o upload do arquivo de log usando a ferramenta do EC2Rescue. Você pode fazer o upload dos resultados em um local fornecido pelo Suporte ou em um bucket do Amazon S3 que você possui.

**Para fazer o upload dos resultados em um local fornecido pelo Suporte**  
Use o comando **./ec2rl upload**. Para `--upload-directory`, especifique o local do arquivo de log. Para `--support-url`, especifique o URL fornecido pelo Suporte.

```
./ec2rl upload --upload-directory=/var/tmp/ec2rl/logfile_location --support-url="url_provided_by_aws_support"
```

**Para fazer o upload dos resultados em um bucket do Amazon S3**  
Use o comando **./ec2rl upload**. Para `--upload-directory`, especifique o local do arquivo de log. Para `--presigned-url`, especifique um URL pré-assinado para o bucket do S3. Para obter mais informações sobre como gerar pre-signed URLs para o Amazon S3, consulte [Fazer upload de objetos usando pre-signed URLs](https://docs.aws.amazon.com/AmazonS3/latest/userguide/PresignedUrlUploadObject.html).

```
./ec2rl upload --upload-directory=/var/tmp/ec2rl/logfile_location --presigned-url="presigned_s3_url"
```

## Criar backups de uma instância do Amazon EC2 no Linux
<a name="ec2rl_creating_backups"></a>

Você pode usar o EC2Rescue para fazer backup da sua instância do Linux criando uma AMI ou criando snapshots dos volumes anexados.

**Criar uma AMI**  
Use o comando `./ec2rl run`, e para --`backup`, especifique `ami`.

```
./ec2rl run --backup=ami
```

**Para criar snapshots multivolume de todos os volumes anexados**  
Use o comando `./ec2rl run`, e para --`backup`, especifique `allvolumes`.

```
./ec2rl run --backup=allvolumes
```

**Para criar um snapshot de um volume anexado específico**  
Use o comando `./ec2rl run`, e para --`backup`, especifique o ID do volume para backup.

```
./ec2rl run --backup=vol-01234567890abcdef
```