Getting started
Prerequisites
- Install DevRev CLI
- Install jq
- Create a dev org
Log in to DevRev for authentication
To authenticate, run the following command:
1 devrev profiles authenticate -o <dev-org-slug> -u <youremail@yourdomain.com>
Initializing a snap-in template
To initialize a snap-in template, run the following command:
The command creates a folder devrev-snaps-typescript-template. This contains a manifest.yaml file and a code folder.
- manifest file defines the resources to be created on the DevRev platform. For detailed information on the various components of a manifest file, see Snap-in Manifest.
- code folder consists of sample starter code for snap-ins. For detailed information on how to get started, see starter example repo.
Creating a snap-in package
To create a snap-in package, run the following command:
1 devrev snap_in_package create-one --slug my-first-snap-in | jq .
- The slug is globally unique. If the slug provided is already taken, a conflict error occurs. This can be resolved by provided a different slug.
- On successful creation, the CLI automatically stores the package ID in its context corresponding to the slug. For more information, refer to the Snap-in Context.
Creating a snap-in version
To create a snap-in version, run the following command:
Output:
1 {2 "id":"don:integration:dvrv-us-1:devo/fOFb0IdZ:snap_in_package/972696ef-32cf-4ec0-81da-5a4a7804fa91:snap_in_version/52c058a9-7d68-4538-b70e-46efc7dfcd0d",3 ...... ,4 "state":"draft"5 }
The CLI automatically stores the version ID in its context. Refer to the Snap-in Context section for more information.
In a package that's not published to the Marketplace, you can have only one snap-in version. If you have an existing snap-in version in the package, the following error message is shown:
1 {2 "debug_message": "can't create a new snap_in_version under snap_in_package <ID> because there is already a non-published snap_in_version under it",3 "message": "Bad Request",4 "type": "bad_request"5 }
To list snap-in versions under the package, run the following command:
To delete the snap-in version, run the following command:
1 devrev snap_in_version delete-one
Installing a snap-in from a snap-in version
To create a snap-in from a snap-in version, run the following command:
To install the snap-in, you must be a member of the Admins group in the dev org.
The CLI automatically stores the snap-in ID in its context. Refer to the Snap-in Context section for more information.
Configuring the snap-in
The snap-in is installed in draft state. It may require some configuration before it can be deployed.
You can access snap-in configuration by using the URL generated by the draft command, or by navigating to the snap-ins page in the DevRev app.
Follow the configuration steps for the snap-in to setup keyrings and inputs if any.
Private keyrings from other creators aren't listed.
To make a connection available to other members in your organisation, create it with the visible to dev org option set to true while creating the connection in the DevRev app.
Deploying the snap-in
Once you have provided the required configuration, the Deploy snap-in button is enabled on the UI. Click on it to deploy the snap-in. That's it, the snap-in should now be active and ready to use.
Deleting the snap-in
The snap-in can be deleted from the UI or run the following command:
1 devrev snap_in delete-one [snap-in id]
If any deactivate hook is specified, it's invoked with is_deletion=true.
Upgrading the snap-in
Once you deploy and test your snap-in, you may want to make changes to it. The changes can be done using a single command.
The above expects the manifest file to be present in the current directory by the name manifest.yaml and the code to be present in the code directory.
The complete documentation for the upgrade command can be found here.