A logo showing the text blog.marcnuri.com
Español
Home»Java»Gradle: Adding the Gradle Wrapper from Docker

Recent Posts

  • Fabric8 Kubernetes Client 7.2 is now available!
  • Connecting to an MCP Server from JavaScript using AI SDK
  • Connecting to an MCP Server from JavaScript using LangChain.js
  • The Future of Developer Tools: Adapting to Machine-Based Developers
  • Connecting to a Model Context Protocol (MCP) Server from Java using LangChain4j

Categories

  • Artificial Intelligence
  • Front-end
  • Go
  • Industry and business
  • Java
  • JavaScript
  • Legacy
  • Operations
  • Personal
  • Pet projects
  • Tools

Archives

  • May 2025
  • April 2025
  • March 2025
  • February 2025
  • January 2025
  • December 2024
  • November 2024
  • August 2024
  • June 2024
  • May 2024
  • April 2024
  • March 2024
  • February 2024
  • January 2024
  • December 2023
  • November 2023
  • October 2023
  • September 2023
  • August 2023
  • July 2023
  • June 2023
  • May 2023
  • April 2023
  • March 2023
  • February 2023
  • January 2023
  • December 2022
  • November 2022
  • October 2022
  • September 2022
  • August 2022
  • July 2022
  • June 2022
  • May 2022
  • March 2022
  • February 2022
  • January 2022
  • December 2021
  • November 2021
  • October 2021
  • September 2021
  • August 2021
  • July 2021
  • January 2021
  • December 2020
  • November 2020
  • October 2020
  • September 2020
  • August 2020
  • July 2020
  • June 2020
  • May 2020
  • February 2020
  • January 2020
  • December 2019
  • October 2019
  • September 2019
  • July 2019
  • March 2019
  • November 2018
  • July 2018
  • June 2018
  • May 2018
  • April 2018
  • March 2018
  • February 2018
  • December 2017
  • July 2017
  • January 2017
  • December 2015
  • November 2015
  • December 2014
  • March 2014
  • February 2011
  • November 2008
  • June 2008
  • May 2008
  • April 2008
  • January 2008
  • November 2007
  • September 2007
  • August 2007
  • July 2007
  • June 2007
  • May 2007
  • April 2007
  • March 2007

Gradle: Adding the Gradle Wrapper from Docker

2021-07-20 in Java tagged Docker / Gradle / Java / Quickie by Marc Nuri | Last updated: 2021-07-23
Versión en Español

The Gradle Wrapper

Gradle recommends the Gradle Wrapper as the preferred way to execute any Gradle build. In a nutshell, the Gradle Wrapper is a shell script that downloads and invokes a given version of Gradle. This has two main advantages. The first is that you don't need to have a Gradle setup in your environment. The second is that you can guarantee that the build script is always executed with the same version of Gradle.

Adding the Gradle Wrapper is as simple as executing the following command:

$ gradle wrapper
> Task :wrapper

BUILD SUCCESSFUL in 0s
1 actionable task: 1 executed

The process is really straightforward, as described in the Gradle documentation. You can even configure most of the wrapper properties by using command line options: options: --gradle-version, --gradle-distribution-url,--distribution-type, etc. However, this assumes that you have a valid Gradle setup in your environment (which basically defeats the purpose of the wrapper).

Adding the Gradle Wrapper from Docker

If you don't have a valid Gradle setup in your system, but you do have Docker, you can still add the wrapper. You can execute the following command to add the Wrapper:

docker run --rm                               \
  -u "$(id -u):$(id -g)"                      \
  -v $(pwd):/opt/gen                          \
  -w /opt/gen                                 \
  gradle:6.9-jre /usr/bin/gradle wrapper

The behavior is the same as if running the command from a local Gradle distribution, so the same command line options apply:

docker run --rm                               \
  -u "$(id -u):$(id -g)"                      \
  -v $(pwd):/opt/gen                          \
  -w /opt/gen                                 \
  gradle:6.9-jre /usr/bin/gradle wrapper --gradle-version 7.1.1 --distribution-type all

The previous command runs the provided /usr/bin/gradle command within the gradle:6.9-jre Docker Image based container.

  • --rm removes the Docker container once the command completes.
  • -u "$(id -u):$(id -g)" forces the Docker container to run as the current user:group. This will allow gradle to generate the Wrapper files with the right permissions.
  • -v $(pwd):/opt/gen mounts the current local directory into the container so that the generated files are persisted locally.
  • -w /opt/gen sets the working directory so that gradle generates the wrapper in the mounted directory.

Finally, to make the Gradle Wrapper files available to the rest of the team, you'll need to check the following files and directories into your version control system (everything except .gradle):

├── gradle
│   └── wrapper
│       ├── gradle-wrapper.jar
│       └── gradle-wrapper.properties
├── gradlew
└── gradlew.bat
An image of the Gradle logo on top of blog.marcnuri.com logo
An image of the Gradle logo on top of blog.marcnuri.com logo
Twitter iconFacebook iconLinkedIn iconPinterest iconEmail icon

Post navigation
Eclipse JKube 1.4.0 is now available!Quarkus 2 + Kubernetes Maven Plugin + GraalVM integration
© 2007 - 2025 Marc Nuri