Using Vespa Cloud for development is easy. See getting started to make your first deployment.
Each deployment of an application to the
dev zone is a separate instance
of the application. Using multiple instances lets developers work with the same application
separately or collaboratively as they prefer.
Consider the deploy command:
$ mvn clean package vespa:deploy -DapiKeyFile=/path-to/uname.tname.pem \ -Denvironment=dev \ -Dregion=aws-us-east-1c \ -Dtenant=mytenant \ -Dapplication=vespacloud-docsearch \ -Dinstance=myuser
This is equivalent to the
vespa:deploy used in the getting started page:
region defaults to the
application is normally set in
instance must be set and can be anything, e.g a user, experiment or team name.
Deployments to dev are downscaled to one small node by default so that prod
applications can be deployed without changing services.xml.
If you need more resources in the dev application, set nodes or resources
explicitly by adding those tags to services.xml with a
see variants in services.xml.
dev zone is not for production serving, and has no uptime guarantees.
An automated Vespa software upgrade can be triggered by
and that may lead to some downtime if you have only one node per cluster
(as with the default auto downsizing).
To override the version, use
-Dvespa.runtime.version=<current deployed version>
In addition to
dev there is also a
perf zone for performance testing.
This does less downscaling of resources, such that tests that can be extrapolated to production
are possible. In other ways this zone works the same way as dev. To deploy to perf, use
Read more in benchmarking.
As Vespa Cloud upgrades daily, a deploy will some times pull the latest Vespa Version. This takes minutes as opposed to the seconds it normally takes. Start the day by deploying to avoid the wait!
A common mistake is
is normally pulled from the pom -
Errors here cause a 401 when deploying.
Likewise for data plane -
remember to copy the public sertificate to
before building and deploying.
Set all keys in the IDE:
-Dtest.categories=system -DapiKeyFile=/path-to/uname.tname.pem -DdataPlaneCertificateFile=/path-to/data-plane-public-cert.pem -DdataPlaneKeyFile=/path-to/data-plane-private-key.pem