go/goreleaser
1
0
Fork 0
mirror of https://github.com/goreleaser/goreleaser.git synced 2025-11-23 22:36:11 +02:00
Code Issues Releases Activity
Files
cefec7c58bd8ece27bf13c7ac897a9e0b0ce0635
goreleaser/www/docs/customization/dockerhub.md
Randy Fay 6353982e33 docs: Minor edits to 'dockerhub' (#4740) 
Minor edits to the `dockerhub` docs.

Thanks for all your [help getting this
going](https://discord.com/channels/890434333251362866/1223342596231925852/1223342596231925852)

I note that you already updated a number of things. Here are just a
couple more edits.

Thanks for the great work!
2024-04-02 13:49:56 -03:00

1.9 KiB
Raw Blame History

DockerHub

Since v1.25 (pro)

!!! success "GoReleaser Pro"

DockerHub is a [GoReleaser Pro feature](/pro/).

DockerHub allows you to set an image description and a full description. However, this is not possible via docker push. This pipe allows you to configure these fields and ensures they are set when publishing your releases.

You also have plenty of customization options:

# goreleaser.yaml

dockerhub:
  - # Your hub.docker.com username. Must have 'editor' permissions
    #
    # Default: "{{ .Env.DOCKER_USERNAME }}"
    # Templates: allowed
    username: "john.doe"

    # Environment variable name to get the push token from.
    # You might want to change it if you have multiple dockerhub configurations.
    #
    # Templates: allowed
    # Default: "DOCKER_PASSWORD"
    secret_name: DOCKER_TOKEN

    # Images to apply the description and/or full description to.
    #
    # Templates: allowed
    images:
      - goreleaser/goreleaser
      - goreleaser/goreleaser-pro

    # Disables the configuration feature in some conditions, for instance, when
    # publishing patch releases.
    # Any value different of 'true' will be considered 'false'.
    #
    # Templates: allowed
    disable: "{{gt .Patch 0}}"

    # The short description of the image.
    #
    # Templates: allowed
    description: A short description

    # The full description of the image.
    #
    # It can be a string directly, or you can use `from_url` or `from_file` to
    # source it from somewhere else.
    #
    # Templates: allowed
    full_description:
      # Loads from an URL.
      from_url:
        # Templates: allowed
        url: https://foo.bar/README.md
        headers:
          x-api-token: "${MYCOMPANY_TOKEN}"

      # Loads from a local file.
      # Overrides `from_url`.
      from_file:
        # Templates: allowed
        path: ./README.md

!!! tip

Learn more about the [name template engine](/customization/templates/).