4.2.3 • Published 8 months ago
koyeb.js v4.2.3
An unofficial wrapper for the Koyeb REST API, enabling you to interact with apps, services and more. Designed to have a simple, intuitive syntax using asynchronous functions.
Features
- Service control (resume, pause, re-deploy)
- Get a list of services and apps
- Support for multiple apps using classes
- Get a specific instance, or the latest
Execute commands on an instance
Deployment & related methods
- Finish instance & service
Metrics
Logs
- Secrets
Install & Import
pnpm add koyeb.js
import * as Koyeb from 'koyeb.js' // ESM
const Koyeb = require('koyeb.js') // CommonJS
Secure your Auth Token
- Head to Account ➟ API
- Create a new access token and copy the generated string.
- Head to your app settings ➟ Environment Variables ➟ Add Variable
- Name the variable
AUTH_TOKEN
and paste your copied token in the 'value' field. - Hit 'Apply'. You can now access your token without exposing it to others!
const token = process.env.AUTH_TOKEN
Initialize an App
const myApp = await new Koyeb.App(token).fromName('appName')
// Alternatively, you can replace fromName with 2 other methods.
.fromID('13j25-4323b2-671f') // The ID of the application.
.fromIndex(0) // The index of the app in your app list.
Service creation and control
// Creating a service from the first in the app list.
const services = await myApp.listServices(),
service = new Koyeb.Service(services[0].id, token)
// Calls `status()` internally and returns a true if we received 'PAUSED'.
console.log(service.paused())
console.log(service.status())
console.log(service.info())
// Each will return true/false if the request succeeded/failed.
// Calling resume/pause when already running/paused will return false.
await service.redeploy()
await service.resume()
await service.pause()
Get an Instance
// Returns the application's current instance.
const myInstance = await new Koyeb.Instance(appID, token).latest()
// Or get a specific instance by its ID.
const myInstance = await new Koyeb.Instance.get(instanceID, token)
Execute commands
// Returns a promise containing the command result.
// This example outputs a list of files & directories on the instance.
const ls = await instance.executeCommand({ command: ['ls'] })
console.log(ls)
// You can also pass 3 optional keys (ttyWidth, ttyHeight, data).
// More info -> https://www.koyeb.com/docs/api#operation/ExecCommand
4.2.3
8 months ago
4.2.2
8 months ago
4.2.1
8 months ago
4.2.0
8 months ago
2.4.5
12 months ago
3.2.0
11 months ago
3.1.0
11 months ago
3.0.0
11 months ago
4.1.0
11 months ago
4.0.1
11 months ago
4.0.0
11 months ago
2.4.1
1 year ago
2.4.3
1 year ago
2.4.2
1 year ago
2.4.4
1 year ago
2.4.0
1 year ago
2.3.0
1 year ago
2.2.0
1 year ago
2.0.0
1 year ago
1.4.0
1 year ago
1.3.0
1 year ago
1.2.1
1 year ago
1.2.0
1 year ago
1.0.0
1 year ago
0.4.0
1 year ago
0.3.1
1 year ago
0.3.0
1 year ago
0.2.0
1 year ago
0.1.0
1 year ago