Create a code bundle
Refer to these guidelines when creating your EdgeKV-enabled EdgeWorkers code bundle.
To create a code bundle, package the following files together, along with any other dependencies as a compressed .tgz (tarball) file:
-
main.js
-
bundle.json
-
edgekv.js
(helper library) -
edgekv_tokens.js
(access token)For more information go to Create a code bundle in the EdgeWorkers User Guide.
Add the main.js and bundle.json files
The main.js
file contains JavaScript source code that contains the event handler functions for EdgeWorkers. The bundle.json
file is the manifest file that includes the necessary metadata information about your application.
-
Create a local folder for your EdgeWorkers code bundle.
-
Create the
main.js
file, write your EdgeWorkers code, and add it to the code bundle folder.You need to use the following import statement to add the
edgekv.js
helper file to your code bundle:
import { EdgeKV } from './edgekv.js';
You'll receive an error message if this import statement is missing even if the
edgekv.js
helper file is included in the code bundle.
You can also download the hello-world example from the EdgeKV GitHub repo.
-
Create the
bundle.json
manifest file and add it to the code bundle folder.For instructions on how to create a
bundle.json
file see Create a code bundle in the EdgeWorkers User Guide.
Add the EdgeKV helper library
Make sure you include the JavaScript helper library that you downloaded in the code bundle. It is required to access the EdgeKV database.
You need version 0.6.2 or higher of the JavaScript helper library to enable automatic token refresh. For more information go to, Generate and retrieve EdgeKV access tokens in this guide.
- Copy the
edgekv.js
file to your code bundle folder.
The the edgekv.js
helper file is not required when using the administrative APIs to control EdgeKV database functions outside of EdgeWorkers code.
Add the access token file
The edgekv.js
library automatically uses the appropriate token to access the corresponding namespace. If a token is missing, an exception is thrown by the EdgeKV methods with a 401 error.
- Add the
edgekv_tokens.js
file containing the EdgeKV access token to your EdgeWorkers code bundle folder.
Updated 2 months ago