An asynchronous Scala client for Fastly's API used to deploy and update configs, decache objects and query the stats API.
libraryDependencies += "com.gu" %% "fastly-api-client" % "latest version"
Use the default AsyncHttpClientConfig,
val client = FastlyApiClient("my-fastly-api-key", "my-service-id")
Or define your own AsyncHttpClientConfig,
val client = FastlyApiClient("my-fastly-api-key",
"my-service-id",
config = Some(asyncHttpClientConfig))
This client uses the HTTP Async Client, have a look there for configuring your own AsyncHttpClientConfig. This is what Dispatch Reboot uses under the hood, too.
Set a proxy if needed,
val client = FastlyApiClient("my-fastly-api-key",
"my-service-id",
proxy = Some(proxyToAccessTheWorld))
All methods return a scala.concurrent.Future[Response]
If you want to block, you must use the Await.result construct.
client.purge(url)
This is the way Fastly recommend performing releases.
client.versionList(...) // find the active version
client.versionClone(...) // clone the active version
client.vclDelete(...) // delete all the VCL files ready for the new ones
client.vclUpload(...) // upload you new VCL files
client.vclSetAsMain(...) // define the main VCL file
client.versionValidate(...) // validate the cloned version
client.versionActivate(...) // activate the cloned version
client.stats(startDatetime, endDatetime, By.minute)
client.stats(startDatetime, endDatetime, By.hour, region = Region.usa)
client.stats(startDatetime,
endDatetime,
By.day,
region = Region.all)
You'll need a config file at ~/.config/fastly/fastlyApiClientTest with these values:
serviceId=<ID of any fastly service>
apiKey=<api key with read-only access to above service>
You may wish to create a service just for this purpose.
