@octopusdeploy/api-client

:octopus: TypeScript API Client for Octopus Deploy

🚀 Getting Started

The TypeScript API Client for Octopus Deploy is easy to use after it's been initialized. Refer to Getting Started for step-by-step set of instructions on setup, initialization, and usage of its functionality.

Documentation

The reference documentation for this library is auto-generated via Typedoc and made available through GitHub Pages: octopusdeploy.github.io/api-client.ts

🏎 Usage

import { Client, ClientConfiguration, Repository } from "@octopusdeploy/api-client";
import type { ProjectResource } from "@octopusdeploy/message-contracts";

const configuration: ClientConfiguration = {
    instanceURL: "instance-url",
    apiKey: "api-key",
    space: "space-id",
    agent: new Agent({ proxy: { hostname: "127.0.0.1", port: 8866 } }), // proxy agent if required
};

const client = await Client.create(configuration);
if (client === undefined) {
    throw new Error("client could not be constructed");
}

const repository = new Repository(client);
const projectNameOrId: string = "project-name-or-ID";

console.log(`Getting project, "${projectNameOrId}"...`);

let project: ProjectResource | undefined;
try {
    project = await repository.projects.find(projectNameOrId);
} catch (error) {
    console.error(error);
}

if (project !== null && project !== undefined) {
    console.log(`Project found: "${project?.Name}" (${project?.Id})`);
} else {
    console.error(`Project, "${projectNameOrId}" not found`);
}

Changelog

2.1.0 (2022-12-09)

Features

• Add support for creating Zip and NuGet packages (#128) (804e2e7)

Bug Fixes

• Fixed an issue with error handling in task waiter (#127) (7e2ec6e)