npx remotion cloudrun sites
Cloud Run is in Alpha, which means APIs may change in any version and documentation is not yet finished. See the changelog to stay up to date with breaking changes.
The npx remotion cloudrun sites
command allows to create, view and delete Remotion projects in your Cloud Storage bucket.
create
npx remotion cloudrun sites create src/index.ts
npx remotion cloudrun sites create src/index.ts
Bundle and upload a Remotion video to a Cloud Storage bucket.
The result will be a URL such as https://storage.googleapis.com/remotioncloudrun-12345/sites/mySite123/index.html
.
If you make changes locally, you need to redeploy the site. Use --site-name
to overwrite an existing site.
You can use this "Serve URL" to render a video on Remotion Cloud Run using:
- The
npx remotion cloudrun render
command. - Locally using the
renderMedia()
andrenderStill()
functions. - Locally using the
npx remotion render
andnpx remotion still
commands
If you are rendering on Cloud Run, you can also pass the site Name (in this case mySite123
) as an abbreviation.
Example output
(1/3) [====================] Bundled video 3975ms
(2/3) [====================] Created bucket 457ms
(3/3) [====================] Uploaded to GCP Storage Bucket 25118ms
Deployed to GCP Cloud Storage!
Site: mySite123
Bucket: remotioncloudrun-12345
Region: us-east1
Serve Url: https://storage.googleapis.com/remotioncloudrun-12345/sites/mySite123/index.html
--region
The GCP region to select. The service accessing the site should also be in this same region to minimise latency.
--site-name
Uploads the project to a specific directory and returns a deterministic URL. If a site already existed under this name, in the same region, it will be overwritten. Can only contain the following characters: 0-9
, a-z
, A-Z
, -
, !
, _
, .
, *
, '
, (
, )
npx remotion cloudrun sites create src/index.ts --site-name=another-site
npx remotion cloudrun sites create src/index.ts --site-name=another-site
Example output
(1/3) [====================] Bundled video 3975ms
(2/3) [====================] Created bucket 457ms
(3/3) [====================] Uploaded to Cloud Storage 25118ms
Deployed to GCP Cloud Storage!
Site: another-site
Bucket: remotioncloudrun-12345
Region: us-east1
Serve Url: https://storage.googleapis.com/remotioncloudrun-12345/sites/another-site/index.html
ls
npx remotion cloudrun sites ls
npx remotion cloudrun sites ls
Get a list of sites. The URL that is printed can be passed to the render
command to render a video.
Example output
2 sites in us-east1, in the remotion-example project.
Site: another-site
Bucket: remotioncloudrun-12345
Region: us-east1
Serve Url: https://storage.googleapis.com/remotioncloudrun-12345/sites/another-site/index.html
Site: test-site
Bucket: remotioncloudrun-12345
Region: us-east1
Serve Url: https://storage.googleapis.com/remotioncloudrun-12345/sites/test-site/index.html
--region
The GCP region to list sites from.
--all-regions
,
Ignores region, returning sites across all regions for the project.
npx remotion cloudrun sites ls --all-regions
npx remotion cloudrun sites ls --all-regions
Example output
3 sites in all regions, in the remotion-example project.
Site: another-site
Bucket: remotioncloudrun-12345
Region: us-east1
Serve Url: https://storage.googleapis.com/remotioncloudrun-12345/sites/another-site/index.html
Site: test-site
Bucket: remotioncloudrun-12345
Region: us-east1
Serve Url: https://storage.googleapis.com/remotioncloudrun-12345/sites/test-site/index.html
Site: central-site
Bucket: remotioncloudrun-abcdefgh
Region: us-central1
Serve Url: https://storage.googleapis.com/remotioncloudrun-abcdefgh/sites/central-site/index.html
--quiet
, -q
Returns only a list of space-separated sites.
npx remotion cloudrun sites ls -q
npx remotion cloudrun sites ls -q
Example output
another-site test-site central-site
rm
Removes a site (or multiple) from Cloud Storage by it's ID.
bash
npx remotion cloudrun sites rm central-sitenpx remotion cloudrun sites rm central-site another-site # multiple at once
bash
npx remotion cloudrun sites rm central-sitenpx remotion cloudrun sites rm central-site another-site # multiple at once
Example output
Site: central-site
Bucket: remotioncloudrun-abcdefgh
Region: us-central1
Serve Url: https://storage.googleapis.com/remotioncloudrun-abcdefgh/sites/central-site/index.html
Delete? (Y/n) Y
Deleted site central-site from bucket remotioncloudrun-abcdefgh.
--region
The GCP region to remove sites from.
The rm
command does not support the --all-regions flag, as it is possible to have the same site name in multiple regions. This makes it difficult to remove multiple site-names from multiple regions.
--yes
, -y
Removes a site (or multiple) without asking for confirmation.
npx remotion cloudrun sites rm central-site -y
npx remotion cloudrun sites rm central-site -y
rmall
Remove all sites in the selected GCP project.
bash
npx remotion cloudrun sites rmall
bash
npx remotion cloudrun sites rmall
Example output
Retrieving sites in us-east1.
Site: another-site
Bucket: remotioncloudrun-12345
Region: us-east1
Serve Url: https://storage.googleapis.com/remotioncloudrun-12345/sites/another-site/index.html
Delete? (Y/n) n
Skipping site - another-site.
Site: test-site
Bucket: remotioncloudrun-12345
Region: us-east1
Serve Url: https://storage.googleapis.com/remotioncloudrun-12345/sites/test-site/index.html
Delete? (Y/n) n
Skipping site - test-site.
--region
The GCP region to remove all sites from.
--all-regions
,
Ignores region, removing sites across all regions for the project.
npx remotion cloudrun sites rmall --all-regions
npx remotion cloudrun sites rmall --all-regions
Example output
Retrieving sites in all regions.
Site: another-site
Bucket: remotioncloudrun-12345
Region: us-east1
Serve Url: https://storage.googleapis.com/remotioncloudrun-12345/sites/another-site/index.html
Delete? (Y/n) n
Skipping site - another-site.
Site: test-site
Bucket: remotioncloudrun-12345
Region: us-east1
Serve Url: https://storage.googleapis.com/remotioncloudrun-12345/sites/test-site/index.html
Delete? (Y/n) n
Skipping site - test-site.
Site: central-site
Bucket: remotioncloudrun-abcdefgh
Region: us-central1
Serve Url: https://storage.googleapis.com/remotioncloudrun-abcdefgh/sites/central-site/index.html
Delete? (Y/n) n
Skipping site - central-site.
--yes
, -y
Removes all sites without asking for confirmation.
npx remotion cloudrun sites rmall -y
npx remotion cloudrun sites rmall -y