Skip to content

Add generic major version tags for InfluxDB Docker images #820

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

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

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