Docs: How to run Astral in Deno Deploy w/ external providers

[janzheng]

Hi there!

I've been running Astral locally and it's been great, but on Deno Deploy I keep getting:

Requires write access to /src/.cache/astral, which cannot be granted in this environment

It seems like other people have figured out how to put Astral on Deno Deploy, so I'm wondering what I need to do?

Basically my code is:

import { launch } from "jsr:@astral/astral";

const generateDocument = async (html: string, options: any = {}) => {
  const browser = await launch();
  const page = await browser.newPage("about:blank");
  
  await page.evaluate((data) => {
    document.documentElement.innerHTML = data.html;
  }, {
    args: [{ html }]
  });

  // Wait for any styles/fonts to load
  await page.waitForTimeout(options.timeout || 2500);

  let result;
  if (options.type === 'pdf') {
    result = await page.pdf({
      format: options.format || 'Letter',
      printBackground: true,
      margin: options.margin || {
        top: '1cm',
        right: '1cm',
        bottom: '1cm',
        left: '1cm'
      }
    });
  } else {
    result = await page.screenshot(options.screenshotOptions);
  }

  await browser.close();
  return result;
};

[lino-levan]

Unfortunately, Deploy does not support running arbitrary binaries. Astral works in deploy through a third-party provider like browserless.

[janzheng]

oh good tip, thank you!

[janzheng]

I'm messing around with Browserless and the examples, passing in the token, etc. — I'm getting a connection and result on a regular POST call (to Browserless v2 API) but somehow on the wss: endpoint it just hangs on launch(), and I can't even seem to be able to close the connection. It might just be a Browserless error, but I'm clueless how to continue, so I'll just keep running locally and using a local tunnel.

Thanks for the help, I'm sure other people have gotten this working lol so I'm just going to close this.

[lino-levan]

I'm hoping to write up better docs for this. Thanks for flagging.