Upsun SDK for NodeJs

CAUTION: This project is currently in Beta, meaning features and APIs may evolve over time. Please report bugs or request new features by creating a GitHub issue.

​

Installation

npm install upsun-sdk-node

​

Authentication

import { UpsunClient, UpsunConfig } from 'upsun-sdk-node';

const config: UpsunConfig = {
  apiKey: process.env.UPSUN_CLI_TOKEN || '',
};

const upsunClient = new UpsunClient(config);

​

Usage

​

Example: List organizations

const organizations = await upsunClient.organizations.list();

​

Example: List projects

const projects = await upsunClient.projects.list('<organizationId>');

​

Example: Redeploy an environment

const result = await upsunClient.environments.redeploy('<projectId>', '<environmentId>');

​

Development

git clone git@github.com:upsun/upsun-sdk-node.git
npm install

​

Architecture of this SDK

• From the JSON specs of our API
• Using @openapitools/openapi-generator-cli
• Which generates a low-level API client
• On top of that, the SDK exposes higher-level task-oriented methods

​

Regenerating API client code

npm run spec:generate:install
npm run spec:full

​

Publishing

1. update your local

git fetch
git checkout main
git pull

2. check existing tags on https://github.com/upsun/upsun-sdk-node/tags
3. Update package.json version to the new release version (highest version + 1)
4. update package-lock.json using:

npm install
git add package.json package-lock.json
git commit -m "bump release version to v<x.y.z>"
git push

5. create a new tag from your local

git tag v<x.y.z>
git push --tag

6. Go on release page: https://github.com/upsun/upsun-sdk-node/releases
7. create a new release based on the previously created tag (Do not forget to autogenerate description in the form)
8. check publishing action status: https://github.com/upsun/upsun-sdk-node/actions
9. check new release version on https://www.npmjs.com/package/upsun-sdk-node

​

Contributing

​

Tests

npm run test

​

License