Pants Cloud Quickstart

This guide shows how to connect your Pantsbuild project to NativeLink Cloud.

1. If you can’t find a pants.toml file, create one in the root directory of your Pantsbuild project:

   • Directoryproject/

     • get-pants.sh
     • BUILD
     • pants.toml

2. Copy the following lines into your pants.toml:

   pants.toml

   [GLOBAL]
   remote_cache_read = true
   remote_cache_write = true
   remote_store_address = "[REMOTE_STORE_ADDRESS]"
   
   [GLOBAL.remote_store_headers]
   x-nativelink-api-key = "[API_KEY]"

   Note

   Fill in the REMOTE_STORE_ADDRESS and API_KEY from the NativeLink Cloud.

3. Run a pants build with the following flags:

   pants --no-pantsd --level=trace --no-local-cache test ::

4. You’ll see remote cache use on the Dashboard page.