Follow these steps to deploy an application to the dev zone in the Vespa Cloud. Find more details and tips in the developer guide. Alternative versions of this guide:
Install the Vespa client:
Using Homebrew:
$ brew install vespa-cli
Alternatively, download it for Windows, Linux and macOS.
Create a tenant in the Vespa Cloud:
Create a tenant at console.vespa-cloud.com (unless you already have one). This requires a Google or GitHub account, and will start your free trial. Make note of the tenant name, it is used in the next steps.
Configure the Vespa client:
$ vespa config set target cloud && \
vespa config set application tenant-name.myapp.default
Use the tenant name from step 2.
This guide uses myapp
as application name and default
as instance name -
learn more.
Authorize Vespa Cloud access:
$ vespa auth login
Follow the instructions from the command to authenticate.
Get a sample application:
$ vespa clone album-recommendation myapp && cd myapp
An application package is the full application configuration. See sample-apps for a full list.
Add public certificate:
$ vespa auth cert
This creates a self-signed certificate for application data plane access (reads and writes), and adds it to the application package files. See the security model for more details.
Deploy the application:
$ vespa deploy --wait 600
The first deployment will take a few minutes while nodes are provisioned - track progress using the link in the response. Subsequent deployments on existing nodes will be quicker.
Feed documents:
$ vespa document ext/A-Head-Full-of-Dreams.json && \ vespa document ext/Love-Is-Here-To-Stay.json && \ vespa document ext/Hardwired...To-Self-Destruct.json
This uses the document/v1 API - read more about feeding.
Run queries:
$ vespa query "select * from music where album contains 'head'"
$ vespa query \ "select * from music where true" \ "ranking=rank_albums" \ "ranking.features.query(user_profile)={{cat:pop}:0.8,{cat:rock}:0.2,{cat:jazz}:0.1}"
These requests use the Query API.