Skip to content

Docs/ecr public images #362

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
mheffner merged 2 commits into from
Aug 3, 2026
Merged

Docs/ecr public images #362

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
7803f8a
docs: point Docker image references at public ECR
mheffner Aug 3, 2026
4a9b969
docs: point python-processors image at public ECR
mheffner Aug 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 11 additions & 12 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ Rotel is fully open-sourced and licensed under the Apache 2.0 license.

### Running Rotel
```bash
docker run -ti -p 4317-4318:4317-4318 streamfold/rotel --debug-log traces --exporter blackhole
docker run -ti -p 4317-4318:4317-4318 public.ecr.aws/rotel-dev/rotel --debug-log traces --exporter blackhole
```

Rotel is now listening on localhost:4317 (gRPC) and localhost:4318 (HTTP).
Expand Down Expand Up @@ -1466,29 +1466,28 @@ may include logging from third-party crates used in Rotel.

## Docker images

On release, Rotel images are published to [Dockerhub](https://hub.docker.com/r/streamfold/rotel) with the following
tags:
On release, Rotel images are published to
[Amazon ECR Public](https://gallery.ecr.aws/rotel-dev/rotel) with the following tags:

- `streamfold/rotel:<release name>`
- `streamfold/rotel:latest`
- `streamfold/rotel:sha-<sha>`
- `public.ecr.aws/rotel-dev/rotel:<release name>`
- `public.ecr.aws/rotel-dev/rotel:latest`
- `public.ecr.aws/rotel-dev/rotel:sha-<sha>`

When running an image, map the OTLP receiver ports to their local values with the flag `-p 4317-4318:4317-4318`.

Rotel releases with built-in Python Processor support and Python 3.13 are also available
on [Dockerhub](https://hub.docker.com/repository/docker/streamfold/rotel-python-processors/general)
with the following tags:
on [Amazon ECR Public](https://gallery.ecr.aws/rotel-dev/python-processors) with the following tags:

- `streamfold/rotel-python-processors:<release name>`
- `streamfold/rotel-python-processors:latest`
- `streamfold/rotel-python-processors:sha-<sha>`
- `public.ecr.aws/rotel-dev/python-processors:<release name>`
- `public.ecr.aws/rotel-dev/python-processors:latest`
- `public.ecr.aws/rotel-dev/python-processors:sha-<sha>`

When running an image, you can mount directories from your local filesystem as volumes to provide processor code
to the container with `-v` flag, for example: `-v ~/my_processor_directory:/processors`. You can then start rotel and
pass in processors like the example below.

```
docker run -ti -p 4317-4318:4317-4318 -v ~/my_processor_director:/processors streamfold/rotel-python-processors:latest
docker run -ti -p 4317-4318:4317-4318 -v ~/my_processor_director:/processors public.ecr.aws/rotel-dev/python-processors:latest
--exporter blackhole --debug-log traces --debug-log-verbosity detailed --otlp-with-trace-processor /processors/my_processor.py`
```

Expand Down
6 changes: 3 additions & 3 deletions src/bin/clickhouse-ddl/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,16 +8,16 @@ Examples:

```shell
# generate DDL for logs
docker run -ti streamfold/rotel-clickhouse-ddl create --endpoint https://abcd1234.us-east-1.aws.clickhouse.cloud:8443 --logs
docker run -ti public.ecr.aws/rotel-dev/clickhouse-ddl create --endpoint https://abcd1234.us-east-1.aws.clickhouse.cloud:8443 --logs

# generate DDL for traces, use the JSON type
docker run -ti streamfold/rotel-clickhouse-ddl create --endpoint https://abcd1234.us-east-1.aws.clickhouse.cloud:8443 --traces --enable-json
docker run -ti public.ecr.aws/rotel-dev/clickhouse-ddl create --endpoint https://abcd1234.us-east-1.aws.clickhouse.cloud:8443 --traces --enable-json
```

If you are executing against a localhost Clickhouse server, add `--network="host"`:

```shell
docker run -ti --network="host" streamfold/rotel-clickhouse-ddl create --endpoint http://localhost:8123 --logs
docker run -ti --network="host" public.ecr.aws/rotel-dev/clickhouse-ddl create --endpoint http://localhost:8123 --logs
```

Full usage:
Expand Down
Loading