Class HttpBuildCache
- All Implemented Interfaces:
BuildCache
Cache entries are loaded via GET and stored via PUT requests.
For a GET request we expect a 200 or 404 response and for PUT we expect any 2xx response. Other responses are treated as recoverable or non-recoverable errors, depending on the status code. E.g. we treat authentication failures (401 and 409) as non-recoverable while an internal server error (500) is recoverable.- Since:
- 3.5
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
credentials
(Action<? super HttpBuildCacheCredentials> configuration) Configures the credentials used to access the HTTP cache backend.Returns the credentials used to access the HTTP cache backend.getUrl()
Returns the URI to the cache.boolean
Specifies whether it is acceptable to communicate with an HTTP build cache backend with an untrusted SSL certificate.void
setAllowUntrustedServer
(boolean allowUntrustedServer) Specifies whether it is acceptable to communicate with an HTTP build cache backend with an untrusted SSL certificate.void
Sets the URL of the cache.void
Sets the URL of the cache.void
Sets the URL of the cache.Methods inherited from class org.gradle.caching.configuration.AbstractBuildCache
isEnabled, isPush, setEnabled, setPush
-
Constructor Details
-
HttpBuildCache
public HttpBuildCache()
-
-
Method Details
-
getUrl
Returns the URI to the cache. -
setUrl
Sets the URL of the cache. The URL must end in a '/'. -
setUrl
Sets the URL of the cache. The URL must end in a '/'.- Throws:
URISyntaxException
-
setUrl
Sets the URL of the cache. The URL must end in a '/'. -
getCredentials
Returns the credentials used to access the HTTP cache backend. -
credentials
Configures the credentials used to access the HTTP cache backend. -
isAllowUntrustedServer
public boolean isAllowUntrustedServer()Specifies whether it is acceptable to communicate with an HTTP build cache backend with an untrusted SSL certificate.The SSL certificate for the HTTP build cache backend may be untrusted since it is internally provisioned or a self-signed certificate.
In such a scenario, you can either configure the build JVM environment to trust the certificate, or set this property to
true
to disable verification of the server's identity.Allowing communication with untrusted servers keeps data encrypted during transmission, but makes it easier for a man-in-the-middle to impersonate the intended server and capture data.
This value has no effect if a server is specified using the HTTP protocol (i.e. has SSL disabled).
- Since:
- 4.2
-
setAllowUntrustedServer
public void setAllowUntrustedServer(boolean allowUntrustedServer) Specifies whether it is acceptable to communicate with an HTTP build cache backend with an untrusted SSL certificate.The SSL certificate for the HTTP build cache backend may be untrusted since it is internally provisioned or a self-signed certificate.
In such a scenario, you can either configure the build JVM environment to trust the certificate, or set this property to
true
to disable verification of the server's identity.Allowing communication with untrusted servers keeps data encrypted during transmission, but makes it easier for a man-in-the-middle to impersonate the intended server and capture data.
This value has no effect if a server is specified using the HTTP protocol (i.e. has SSL disabled).
- Since:
- 4.2
-