Skip to navigation

CDN Integration

A CDN (content delivery network) is a set of servers around the world that keep copies of your files, so users download them from a nearby server instead of from the bucket every time. Putting the IBEE CDN in front of a bucket makes public files load faster, takes load off the bucket, and gives you an HTTPS address and an optional custom domain. This page covers the Object Storage side; the full CDN reference is Network & Security → CDN.

When to use the CDN

You want to…Use
Serve website assets, images or downloads to many users, fastCDN in front of the bucket (this page)
Serve a single-page app with deep links like /dashboardCDN with Enable SPA — see Static Site Hosting
Serve a public bucket on your own hostname, without cachingA bucket custom domain
Share private filesPresigned URLs, not the CDN

How it works

  1. You create a distribution — a CDN configuration — with the bucket as its origin (where the CDN fetches files from).
  2. The first request for a file goes to the bucket; the CDN stores a copy for as long as the cache policy says.
  3. Later requests are answered from the cache at https://dl-….cdn.ibee.ai/OBJECT-KEY, or your own domain.

Before you begin

Put the CDN in front of a bucket

1

Open CDN

In the portal sidebar, click CDN under Network & Security, then Create CDN.

2

Fill in the dialog

In Create CDN Distribution:

FieldValue
NameFor example assets-prod (placeholder my-cdn-distribution)
Origin TypeObject Storage Bucket — Use an existing bucket from your storage
BucketPick the bucket; use Search buckets… to filter
Cache PolicySee the table below

Don’t choose Custom Origin: distributions with a custom origin don’t work at the moment.

3

Create it

Click Create Distribution. The distribution gets a CDN URL such as dl-3f9c2a1b.cdn.ibee.ai with an HTTPS certificate.

Choose a cache policy

PolicyHow long files stay cachedBest for
Static Assets1 yearImages, fonts, CSS and JavaScript with version numbers or hashes in their names
Media Files30 daysVideo and audio
Short Cache1 hourFiles that change often
No CacheNot cachedContent that must always be fresh

A changed file isn’t seen by users until its cached copy expires or you purge it. With Static Assets, give each new version a new file name, or purge after you upload.

Use your own domain

To serve the CDN from cdn.example.com, create a CNAME record from your subdomain to cname.cdn.ibee.ai, then click Add Domain on the distribution’s page. See CDN → Custom domains.

Don’t put the same hostname on the bucket’s own Custom Domains tab. A bucket custom domain serves files directly from the bucket and skips the CDN cache.

Verify

Request a file twice through the CDN URL:

curl -I https://dl-3f9c2a1b.cdn.ibee.ai/images/logo.png

HTTP/2 200 means the CDN reached the bucket. The distribution’s Metrics tab shows requests, Data delivered and Cache hit rate — the share of requests answered from the cache.

Update or purge cached files

After you replace a file in the bucket, click Purge CDN on the distribution’s page to remove the cached copy by URL or prefix, or Purge Everything. Purging everything briefly increases load on the bucket while the cache refills. See CDN → Purge cached content.

Limits and billing

Value
Cache times1 hour, 30 days or 1 year, or no caching
OriginA public bucket in the same organization
CDN URLdl-….cdn.ibee.ai, with HTTPS
BillingCDN usage is billed as CDN, separately from Object Storage. The CDN’s own fetches from the bucket aren’t billed as Object Storage egress.

Troubleshooting

You seeWhat it meansWhat to do
403 from the CDN URLThe bucket isn’t publicTurn on Public Access on the bucket.
404 from the CDN URLThe key is wrong (case-sensitive) or the file doesn’t existCheck the full key in the bucket.
Old content after an uploadThe cached copy hasn’t expiredPurge the file, or use versioned file names.
The custom domain doesn’t loadDNS hasn’t updated, or the CNAME points at the bucket instead of cname.cdn.ibee.aiCheck with dig cdn.example.com CNAME +short.
Deep links in a single-page app return 404SPA mode is offTick Enable SPA on the distribution’s Overview tab.