Skip to main content

DigitalOcean

DigitalOcean is a cloud infrastructure provider and platform-as-a-service (PaaS) company that offers cloud computing services, virtual machines, and developer-friendly tools for deploying, managing, and scaling applications. DigitalOcean provides simplified cloud infrastructure solutions primarily targeted at developers, startups, and small to medium-sized businesses looking for cost-effective and straightforward cloud hosting alternatives to larger providers like AWS, Azure, or Google Cloud Platform.

CategoryCloud
DirectionQuery source
Sign-inPersonal Access Token
Query languagesSQLite
Tables24
Websitedigitalocean.com

Before you start​

Huntbase signs in to DigitalOcean with Personal Access Token. Create the credential in DigitalOcean first, then keep it to hand for the Connect step.

  1. In the DigitalOcean Control Panel, click Account › API in the main menu.
  2. On the Tokens tab, in Personal access tokens, click Generate New Token.
  3. Enter a Token name, choose an Expiration, and under Scopes select Read Only.
  4. Click Generate Token and copy the token. It is shown only once.

Permissions:

  • Read Only
Watch out for
  • You cannot change a token's scopes after you create it. To change access, create a new token.

For the vendor's own instructions, see DigitalOcean personal access token documentation.

tip

Use a dedicated, read-only credential for Huntbase where the product allows it. Huntbase only needs to read.

Connect DigitalOcean​

  1. Go to Connections and click New connection, or click New connection on the DigitalOcean product page.
  2. On Product, pick DigitalOcean and choose the Owner.
  3. On Details, give the connection a Name and, optionally, a Description.
  4. On Connect, fill in the settings and credentials described below.
  5. On Verify, review the summary and click Create & check.

For everything else on the setup page — saving a draft, I'll do this later, and what each check result means — see Connections.

Credentials​

The only Method is Personal Access Token. Enter a Credential label (for example Production), then fill in:

FieldRequiredNotes
Personal Access TokenYesSecret — not shown again after you save it.

Query it​

Once connected, DigitalOcean can serve these languages in a query tab, and Scout can use it when you ask in Auto:

LanguageUse it for
SQLiteSQL over the 24 tables listed below, alongside every other connected source.

Tables​

DigitalOcean adds 24 tables. Browse their columns from Schema in the query bar's ⋯ menu.

All 24 tables
TableContains
digitalocean_accountRetrieve information about your current account.
digitalocean_actionActions are records of events that have occurred on the resources in your account. These can be things like rebooting a Action, or transferring an image to a new region.
digitalocean_alert_policyDigitalOcean Alert Policy
digitalocean_appDigitalOcean App
digitalocean_balanceBalance information for the current account.
digitalocean_billBilling history is a record of billing events for your account. For example, entries may include events like payments made, invoices issued, or credits granted.
digitalocean_container_registryDigitalOcean Container Registry
digitalocean_databaseDigitalOcean's managed database service simplifies the creation and management of highly available database clusters. Currently, it offers support for PostgreSQL, Redis, and MySQL.
digitalocean_domainDigitalOcean Domain
digitalocean_dropletA Droplet is a DigitalOcean virtual machine.
digitalocean_firewallDigitalOcean Cloud Firewalls are a network-based, stateful firewall service for Droplets provided at no additional cost. Cloud firewalls block all traffic that isn’t expressly permitted by a rule.
digitalocean_floating_ipDigitalOcean Floating IPs are publicly-accessible static IP addresses that can be mapped to one of your Droplets. They can be used to create highly available setups or other configurations requiring movable addresses.
digitalocean_imageA DigitalOcean image can be used to create a Droplet and may come in a number of flavors. Currently, there are five types of images: snapshots, backups, applications, distributions, and custom images.
digitalocean_keyDigitalOcean allows you to add SSH public keys to the interface so that you can embed your public key into a Droplet at the time of creation. Only the public key is required to take advantage of this functionality.
digitalocean_kubernetes_clusterDigitalOcean Kubernetes (DOKS) is a managed Kubernetes service that lets you deploy Kubernetes clusters without the complexities of handling the control plane and containerized infrastructure. Clusters are compatible with standard Kubernetes toolchains and integrate natively with DigitalOcean Load Balancers and block storage volumes.
digitalocean_kubernetes_node_poolDigitalOcean Kubernetes Node Pool
digitalocean_load_balancerDigitalOcean Load Balancers provide a way to distribute traffic across multiple Droplets.
digitalocean_projectProjects allow you to organize your resources into groups that fit the way you work. You can group resources (like Droplets, Spaces, load balancers, domains, and floating IPs) in ways that align with the applications you host on DigitalOcean.
digitalocean_regionA region in DigitalOcean represents a datacenter where Droplets can be deployed and images can be transferred. Each region represents a specific datacenter in a geographic location. Some geographical locations may have multiple "regions" available. This means that there are multiple datacenters available within that area.
digitalocean_sizeThe sizes objects represent different packages of hardware resources that can be used for Droplets. This includes the amount of RAM, the number of virtual CPUs, disk space, and transfer. The size object also includes the pricing details and the regions that the size is available in.
digitalocean_snapshotSnapshots are saved instances of a Droplet or a block storage volume.
digitalocean_tagA tag is a label that can be applied to a resource (currently Droplets, Images, Volumes, Volume Snapshots, and Database clusters) in order to better organize or facilitate the lookups and actions on it.
digitalocean_volumeDigitalOcean Block Storage Volumes provide expanded storage capacity for your Droplets and can be moved between Droplets within a specific region. Volumes function as raw block devices, meaning they appear to the operating system as locally attached storage which can be formatted using any file system supported by the OS.
digitalocean_vpcVPCs (virtual private clouds) are virtual networks containing resources that can communicate with each other in full isolation using private IP addresses.

Next steps​