digital-ocean

# Digital Ocean

Digital Ocean is a cloud infrastructure provider that offers virtual servers, storage, and networking services. It's popular among developers and small to medium-sized businesses for deploying and scaling web applications and websites. They provide a simple and developer-friendly interface for managing cloud resources.

Official docs: https://developers.digitalocean.com/

## Digital Ocean Overview

- **Droplet**
  - **Snapshot**
- **Volume**
  - **Snapshot**
- **Image**
- **SSH Key**
- **Floating IP**
- **Project**
- **Domain**
- **Load Balancer**
- **Database**
- **CDN Endpoint**
- **Firewall**
- **Tag**
- **Account**
- **Region**
- **Size**

## Working with Digital Ocean

This skill uses the Membrane CLI to interact with Digital Ocean. Membrane handles authentication and credentials refresh automatically — so you can focus on the integration logic rather than auth plumbing.

### Install the CLI

Install the Membrane CLI so you can run `membrane` from the terminal:

```bash
npm install -g @membranehq/cli
```

### First-time setup

```bash
membrane login --tenant
```

A browser window opens for authentication.

**Headless environments:** Run the command, copy the printed URL for the user to open in a browser, then complete with `membrane login complete <code>`.

### Connecting to Digital Ocean

1. **Create a new connection:**
   ```bash
   membrane search digital-ocean --elementType=connector --json
   ```
   Take the connector ID from `output.items[0].element?.id`, then:
   ```bash
   membrane connect --connectorId=CONNECTOR_ID --json
   ```
   The user completes authentication in the browser. The output contains the new connection id.

### Getting list of existing connections
When you are not sure if connection already exists:
1. **Check existing connections:**
   ```bash
   membrane connection list --json
   ```
   If a Digital Ocean connection exists, note its `connectionId`


### Searching for actions

When you know what you want to do but not...