Skip to content

Add generic major version tags for InfluxDB Docker images #820

@jstirnaman

Description

@jstirnaman

Summary

We need to add generic major version tags to the InfluxDB Docker images to support version-agnostic documentation and make upgrades smoother for users.

Current State

Based on Docker Hub, we currently have:

  • influxdb:3-core
  • influxdb:3-enterprise
  • influxdb:2
  • influxdb:1.11, influxdb:1.11-data, influxdb:1.11-meta (specific versions only)
  • influxdb:latest (points to v2, should be deprecated)

Requested Changes

1. Add Generic v1 Tags

Create these tags that point to the latest v1 release:

  • influxdb:1influxdb:1.11.8 (latest v1)
  • influxdb:1-datainfluxdb:1.11.8-data (or latest v1 enterprise data)
  • influxdb:1-metainfluxdb:1.11.8-meta (or latest v1 enterprise meta)

2. Update Process

These generic tags should be updated automatically when new minor versions are released (e.g., when 1.12 is released, influxdb:1 should point to 1.12).

3. Deprecate Ambiguous Tags

Consider deprecating (with notices, but not removing):

  • influxdb:latest - Currently points to v2, causes confusion
  • influxdb:enterprise - Unclear which version
  • influxdb:core - Unclear which version

Benefits

  1. Documentation stability: We can reference influxdb:1, influxdb:2, influxdb:3-core without updating docs for every release
  2. Clear upgrade path: Users understand v3 is latest, v2 is previous, v1 is legacy
  3. Consistency: Matches the pattern already established with influxdb:2 and influxdb:3-*

Implementation

# Create the tags
docker tag influxdb:1.11.8 influxdb:1
docker tag influxdb:1.11.8-data influxdb:1-data
docker tag influxdb:1.11.8-meta influxdb:1-meta

# Push to Docker Hub
docker push influxdb:1
docker push influxdb:1-data
docker push influxdb:1-meta

Related PR

This supports the Docker Hub documentation improvements in https://github.com/jstirnaman/dockerhub-docs/tree/rc/docker-library/docs. Once the tags are added, I'll push https://github.com/jstirnaman/dockerhub-docs/tree/rc/docker-library/docs to PR docker-library/docs#2600

cc @bpfeife

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions