This change publishes a build scan to ge.spring.io for every local build from an authenticated Spring committer and for CI where appropriate access tokens are available. The build will not fail if publishing fails. This change also allows the build to benefit from remote build caching, providing faster builds for all contributors. Additionally, the project will have access to all features of Gradle Enterprise such as: - Dashboards to view all historical build scans, along with performance trends over time - Build failure analytics for enhanced investigation and diagnosis of build failures - Test failure analytics to better understand trends and causes around slow, failing, and flaky tests
44 lines
1.7 KiB
Plaintext
44 lines
1.7 KiB
Plaintext
image:https://spring.io/badges/spring-credhub/snapshot.svg[link=https://projects.spring.io/spring-credhub#quick-start] image:https://img.shields.io/badge/Revved%20up%20by-Gradle%20Enterprise-06A0CE?logo=Gradle&labelColor=02303A["Revved up by Gradle Enterprise", link="https://ge.spring.io/scans?&search.rootProjectNames=spring-credhub"]
|
|
|
|
== Spring CredHub
|
|
|
|
Spring CredHub provides client-side support for storing, retrieving, and deleting credentials from a https://github.com/cloudfoundry-incubator/credhub[CredHub] server running in a https://www.cloudfoundry.org/[Cloud Foundry] platform.
|
|
|
|
See the https://spring.io/projects/spring-credhub[project site] and https://docs.spring.io/spring-credhub/docs/current/reference/html5/[reference documentation] for more information.
|
|
|
|
=== Demo Application
|
|
|
|
A simple application that demonstrates the use of Spring CredHub is available in link:/spring-credhub-demo[this repository].
|
|
|
|
== Building
|
|
|
|
=== Basic Compile and Unit Tests
|
|
|
|
To build the source you will need to install JDK 17.
|
|
|
|
Spring CredHub uses Gradle for most build-related activities, and you should be able to get off the ground quite quickly by cloning the project you are interested in and typing:
|
|
|
|
[source,bash]
|
|
----
|
|
./gradlew build
|
|
----
|
|
|
|
=== Integration Tests
|
|
|
|
Spring CredHub integration tests need a CredHub server.
|
|
|
|
Refer to link:credhub-server/README.adoc[credhub-server] for information on how to start it up.
|
|
|
|
Once running they can be executed with:
|
|
|
|
[source,bash]
|
|
----
|
|
./gradlew build -PintegrationTests --no-parallel
|
|
----
|
|
|
|
=== Working with the code
|
|
|
|
If you don't have an IDE preference we would recommend that you use
|
|
https://www.springsource.com/developer/sts[Spring Tools Suite] or
|
|
https://eclipse.org[Eclipse] when working with the code.
|