Skip to main content

getServices()

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.

Retrieves a list of Remotion services deployed to GCP Cloud Run.

The parameter compatibleOnly determines whether only services that are compatible with the installed version of Remotion Cloud Run should be returned.

note

The Cloud Run service is versioned and the version of the service must match the version of the @remotion/cloudrun package. So if you upgrade Remotion, you should deploy a new service or otherwise you might get an empty array from this function.

To get information about only a single service, use getServiceInfo().

If you are sure that a service exists, you can also guess the name of it using speculateServiceName() and save an API call to Cloud Run.

Example

ts
import { getServices } from "@remotion/cloudrun";
 
const info = await getServices({
region: "us-east1",
compatibleOnly: true,
});
 
for (const service of info) {
console.log(service.serviceName); // "remotion--3-3-82--mem512mi--cpu1-0"
console.log(service.timeoutInSeconds); // 300
console.log(service.memoryLimit); // 512Mi
console.log(service.cpuLimit); // 1.0
console.log(service.remotionVersion); // "4.0.1"
console.log(service.uri); // "https://remotion--3-3-82--mem512mi--cpu1-0--t-300-1a2b3c4d5e-ue.a.run.app"
console.log(service.region); // "us-east1"
console.log(service.consoleUrl); // "https://console.cloud.google.com/run/detail/us-east1/remotion--3-3-82--mem512mi--cpu1-0--t-300/logs"
}
ts
import { getServices } from "@remotion/cloudrun";
 
const info = await getServices({
region: "us-east1",
compatibleOnly: true,
});
 
for (const service of info) {
console.log(service.serviceName); // "remotion--3-3-82--mem512mi--cpu1-0"
console.log(service.timeoutInSeconds); // 300
console.log(service.memoryLimit); // 512Mi
console.log(service.cpuLimit); // 1.0
console.log(service.remotionVersion); // "4.0.1"
console.log(service.uri); // "https://remotion--3-3-82--mem512mi--cpu1-0--t-300-1a2b3c4d5e-ue.a.run.app"
console.log(service.region); // "us-east1"
console.log(service.consoleUrl); // "https://console.cloud.google.com/run/detail/us-east1/remotion--3-3-82--mem512mi--cpu1-0--t-300/logs"
}

Argument

An object containing the following properties:

region

The GCP region that you would like to query.

ts
import { getServices } from "@remotion/cloudrun";
 
const info = await getServices({
region: "us-west1",
compatibleOnly: true,
});
 
for (const service of info) {
console.log(service.serviceName); // "remotion--3-3-82--mem2gi--cpu2--t-1100"
console.log(service.timeoutInSeconds); // 1100
console.log(service.memoryLimit); // 2Gi
console.log(service.cpuLimit); // 2
console.log(service.remotionVersion); // "3.3.82"
console.log(service.uri); // "https://remotion--3-3-82--mem2gi--cpu2--t-1100-1a2b3c4d5e-uw.a.run.app"
console.log(service.region); // "us-west1"
console.log(service.consoleUrl); // "https://console.cloud.google.com/run/detail/us-west1/remotion--3-3-82--mem2gi--cpu2--t-1100/logs"
}
ts
import { getServices } from "@remotion/cloudrun";
 
const info = await getServices({
region: "us-west1",
compatibleOnly: true,
});
 
for (const service of info) {
console.log(service.serviceName); // "remotion--3-3-82--mem2gi--cpu2--t-1100"
console.log(service.timeoutInSeconds); // 1100
console.log(service.memoryLimit); // 2Gi
console.log(service.cpuLimit); // 2
console.log(service.remotionVersion); // "3.3.82"
console.log(service.uri); // "https://remotion--3-3-82--mem2gi--cpu2--t-1100-1a2b3c4d5e-uw.a.run.app"
console.log(service.region); // "us-west1"
console.log(service.consoleUrl); // "https://console.cloud.google.com/run/detail/us-west1/remotion--3-3-82--mem2gi--cpu2--t-1100/logs"
}

compatibleOnly

If true, only services that match the version of the current Remotion Cloud run package are returned. If false, all Remotion services are returned.

Return value

A promise resolving to an array of objects with the following properties:

serviceName

The name of the service.

memoryLimit

The upper bound on the amount of RAM that the Cloud Run service can consume.

cpuLimit

The maximum number of CPU cores that the Cloud Run service can use to process requests.

remotionVersion

The Remotion version of the service. Remotion is versioning the Cloud Run service and a render can only be triggered from a version of @remotion/cloudrun that is matching the one of the service.

timeoutInSeconds

The timeout that has been assigned to the Cloud Run service.

uri

The endpoint of the service.

region

The region of the deployed service. Useful if passing 'all regions' to the region input.

consoleUrl

A link to the GCP console page for this service. Specifically, a link to logs display.

See also