readimds 0.1.0

CLI for AWS EC2 IMDSv2 (Instance Metadata Service)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

# readimds

Small CLI for AWS EC2 **IMDSv2** (Instance Metadata Service). Run on an EC2 instance to read instance metadata and instance tags without shelling out to `curl`.

## Install

```bash
cargo install readimds
```

## Usage

```bash
readimds [OPTIONS] <SUBCOMMAND>
```

| Subcommand | Description |
|------------|-------------|
| `token` | Get an IMDSv2 session token |
| `metadata <path>` | Fetch a metadata path (e.g. `instance-id`, `ami-id`) |
| `tag <key>` | Get an instance tag value (no newline; for `VAR=$(readimds tag Name)`) |

Run with no arguments or `--help` for the full usage guide.

## Examples

```bash
# Session token
readimds token

# Instance ID and AMI
readimds metadata instance-id
readimds metadata ami-id

# Instance tag into a variable (no trailing newline)
NAME=$(readimds tag Name)
ENV=$(readimds tag Environment)
```

## Requirements

- Must run on an EC2 instance (IMDS is only available from the instance).
- Instance metadata options: IMDSv2 required (or allow both v1 and v2). Token TTL used is 300 seconds.

## License

MIT