FlexibleAppVersion class
Flexible App Version resource to create a new version of flexible GAE Application. Based on Google Compute Engine, the App Engine flexible environment automatically scales your app up and down while also balancing the load. Learn about the differences between the standard environment and the flexible environment at https://cloud.google.com/appengine/docs/the-appengine-environments.
> Note: The App Engine flexible environment service account uses the member ID service-[YOUR_PROJECT_NUMBER]@gae-api-prod.google.com.iam.gserviceaccount.com
It should have the App Engine Flexible Environment Service Agent role, which will be applied when the appengineflex.googleapis.com service is enabled.
To get more information about FlexibleAppVersion, see:
- API documentation
- How-to Guides
- Official Documentation
Example Usage
App Engine Flexible App Version
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const myProject = new gcp.organizations.Project("my_project", {
name: "appeng-flex",
projectId: "appeng-flex",
orgId: "123456789",
billingAccount: "000000-0000000-0000000-000000",
deletionPolicy: "DELETE",
});
const app = new gcp.appengine.Application("app", {
project: myProject.projectId,
locationId: "us-central",
});
const service = new gcp.projects.Service("service", {
project: myProject.projectId,
service: "appengineflex.googleapis.com",
disableDependentServices: false,
});
const customServiceAccount = new gcp.serviceaccount.Account("custom_service_account", {
project: service.project,
accountId: "my-account",
displayName: "Custom Service Account",
});
const gaeApi = new gcp.projects.IAMMember("gae_api", {
project: service.project,
role: "roles/compute.networkUser",
member: pulumi.interpolate`serviceAccount:${customServiceAccount.email}`,
});
const logsWriter = new gcp.projects.IAMMember("logs_writer", {
project: service.project,
role: "roles/logging.logWriter",
member: pulumi.interpolate`serviceAccount:${customServiceAccount.email}`,
});
const storageViewer = new gcp.projects.IAMMember("storage_viewer", {
project: service.project,
role: "roles/storage.objectViewer",
member: pulumi.interpolate`serviceAccount:${customServiceAccount.email}`,
});
const bucket = new gcp.storage.Bucket("bucket", {
project: myProject.projectId,
name: "appengine-static-content",
location: "US",
});
const object = new gcp.storage.BucketObject("object", {
name: "hello-world.zip",
bucket: bucket.name,
source: new pulumi.asset.FileAsset("./test-fixtures/hello-world.zip"),
});
const myappV1 = new gcp.appengine.FlexibleAppVersion("myapp_v1", {
versionId: "v1",
project: gaeApi.project,
service: "default",
runtime: "nodejs",
flexibleRuntimeSettings: {
operatingSystem: "ubuntu24",
runtimeVersion: "24",
},
entrypoint: {
shell: "node ./app.js",
},
deployment: {
zip: {
sourceUrl: pulumi.interpolate`https://storage.googleapis.com/${bucket.name}/${object.name}`,
},
},
livenessCheck: {
path: "/",
},
readinessCheck: {
path: "/",
},
envVariables: {
port: "8080",
},
handlers: [{
urlRegex: ".*\\/my-path\\/*",
securityLevel: "SECURE_ALWAYS",
login: "LOGIN_REQUIRED",
authFailAction: "AUTH_FAIL_ACTION_REDIRECT",
staticFiles: {
path: "my-other-path",
uploadPathRegex: ".*\\/my-path\\/*",
},
}],
automaticScaling: {
coolDownPeriod: "120s",
cpuUtilization: {
targetUtilization: 0.5,
},
},
noopOnDestroy: true,
serviceAccount: customServiceAccount.email,
});
import pulumi
import pulumi_gcp as gcp
my_project = gcp.organizations.Project("my_project",
name="appeng-flex",
project_id="appeng-flex",
org_id="123456789",
billing_account="000000-0000000-0000000-000000",
deletion_policy="DELETE")
app = gcp.appengine.Application("app",
project=my_project.project_id,
location_id="us-central")
service = gcp.projects.Service("service",
project=my_project.project_id,
service="appengineflex.googleapis.com",
disable_dependent_services=False)
custom_service_account = gcp.serviceaccount.Account("custom_service_account",
project=service.project,
account_id="my-account",
display_name="Custom Service Account")
gae_api = gcp.projects.IAMMember("gae_api",
project=service.project,
role="roles/compute.networkUser",
member=custom_service_account.email.apply(lambda email: f"serviceAccount:{email}"))
logs_writer = gcp.projects.IAMMember("logs_writer",
project=service.project,
role="roles/logging.logWriter",
member=custom_service_account.email.apply(lambda email: f"serviceAccount:{email}"))
storage_viewer = gcp.projects.IAMMember("storage_viewer",
project=service.project,
role="roles/storage.objectViewer",
member=custom_service_account.email.apply(lambda email: f"serviceAccount:{email}"))
bucket = gcp.storage.Bucket("bucket",
project=my_project.project_id,
name="appengine-static-content",
location="US")
object = gcp.storage.BucketObject("object",
name="hello-world.zip",
bucket=bucket.name,
source=pulumi.FileAsset("./test-fixtures/hello-world.zip"))
myapp_v1 = gcp.appengine.FlexibleAppVersion("myapp_v1",
version_id="v1",
project=gae_api.project,
service="default",
runtime="nodejs",
flexible_runtime_settings={
"operating_system": "ubuntu24",
"runtime_version": "24",
},
entrypoint={
"shell": "node ./app.js",
},
deployment={
"zip": {
"source_url": pulumi.Output.all(
bucketName=bucket.name,
objectName=object.name
).apply(lambda resolved_outputs: f"https://storage.googleapis.com/{resolved_outputs['bucketName']}/{resolved_outputs['objectName']}")
,
},
},
liveness_check={
"path": "/",
},
readiness_check={
"path": "/",
},
env_variables={
"port": "8080",
},
handlers=[{
"url_regex": ".*\\/my-path\\/*",
"security_level": "SECURE_ALWAYS",
"login": "LOGIN_REQUIRED",
"auth_fail_action": "AUTH_FAIL_ACTION_REDIRECT",
"static_files": {
"path": "my-other-path",
"upload_path_regex": ".*\\/my-path\\/*",
},
}],
automatic_scaling={
"cool_down_period": "120s",
"cpu_utilization": {
"target_utilization": 0.5,
},
},
noop_on_destroy=True,
service_account=custom_service_account.email)
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var myProject = new Gcp.Organizations.Project("my_project", new()
{
Name = "appeng-flex",
ProjectId = "appeng-flex",
OrgId = "123456789",
BillingAccount = "000000-0000000-0000000-000000",
DeletionPolicy = "DELETE",
});
var app = new Gcp.AppEngine.Application("app", new()
{
Project = myProject.ProjectId,
LocationId = "us-central",
});
var service = new Gcp.Projects.Service("service", new()
{
Project = myProject.ProjectId,
ServiceName = "appengineflex.googleapis.com",
DisableDependentServices = false,
});
var customServiceAccount = new Gcp.ServiceAccount.Account("custom_service_account", new()
{
Project = service.Project,
AccountId = "my-account",
DisplayName = "Custom Service Account",
});
var gaeApi = new Gcp.Projects.IAMMember("gae_api", new()
{
Project = service.Project,
Role = "roles/compute.networkUser",
Member = customServiceAccount.Email.Apply(email => $"serviceAccount:{email}"),
});
var logsWriter = new Gcp.Projects.IAMMember("logs_writer", new()
{
Project = service.Project,
Role = "roles/logging.logWriter",
Member = customServiceAccount.Email.Apply(email => $"serviceAccount:{email}"),
});
var storageViewer = new Gcp.Projects.IAMMember("storage_viewer", new()
{
Project = service.Project,
Role = "roles/storage.objectViewer",
Member = customServiceAccount.Email.Apply(email => $"serviceAccount:{email}"),
});
var bucket = new Gcp.Storage.Bucket("bucket", new()
{
Project = myProject.ProjectId,
Name = "appengine-static-content",
Location = "US",
});
var @object = new Gcp.Storage.BucketObject("object", new()
{
Name = "hello-world.zip",
Bucket = bucket.Name,
Source = new FileAsset("./test-fixtures/hello-world.zip"),
});
var myappV1 = new Gcp.AppEngine.FlexibleAppVersion("myapp_v1", new()
{
VersionId = "v1",
Project = gaeApi.Project,
Service = "default",
Runtime = "nodejs",
FlexibleRuntimeSettings = new Gcp.AppEngine.Inputs.FlexibleAppVersionFlexibleRuntimeSettingsArgs
{
OperatingSystem = "ubuntu24",
RuntimeVersion = "24",
},
Entrypoint = new Gcp.AppEngine.Inputs.FlexibleAppVersionEntrypointArgs
{
Shell = "node ./app.js",
},
Deployment = new Gcp.AppEngine.Inputs.FlexibleAppVersionDeploymentArgs
{
Zip = new Gcp.AppEngine.Inputs.FlexibleAppVersionDeploymentZipArgs
{
SourceUrl = Output.Tuple(bucket.Name, @object.Name).Apply(values =>
{
var bucketName = values.Item1;
var objectName = values.Item2;
return $"https://storage.googleapis.com/{bucketName}/{objectName}";
}),
},
},
LivenessCheck = new Gcp.AppEngine.Inputs.FlexibleAppVersionLivenessCheckArgs
{
Path = "/",
},
ReadinessCheck = new Gcp.AppEngine.Inputs.FlexibleAppVersionReadinessCheckArgs
{
Path = "/",
},
EnvVariables =
{
{ "port", "8080" },
},
Handlers = new[]
{
new Gcp.AppEngine.Inputs.FlexibleAppVersionHandlerArgs
{
UrlRegex = ".*\\/my-path\\/*",
SecurityLevel = "SECURE_ALWAYS",
Login = "LOGIN_REQUIRED",
AuthFailAction = "AUTH_FAIL_ACTION_REDIRECT",
StaticFiles = new Gcp.AppEngine.Inputs.FlexibleAppVersionHandlerStaticFilesArgs
{
Path = "my-other-path",
UploadPathRegex = ".*\\/my-path\\/*",
},
},
},
AutomaticScaling = new Gcp.AppEngine.Inputs.FlexibleAppVersionAutomaticScalingArgs
{
CoolDownPeriod = "120s",
CpuUtilization = new Gcp.AppEngine.Inputs.FlexibleAppVersionAutomaticScalingCpuUtilizationArgs
{
TargetUtilization = 0.5,
},
},
NoopOnDestroy = true,
ServiceAccount = customServiceAccount.Email,
});
});
package main
import (
"fmt"
"github.com/pulumi/pulumi-gcp/sdk/v9/go/gcp/appengine"
"github.com/pulumi/pulumi-gcp/sdk/v9/go/gcp/organizations"
"github.com/pulumi/pulumi-gcp/sdk/v9/go/gcp/projects"
"github.com/pulumi/pulumi-gcp/sdk/v9/go/gcp/serviceaccount"
"github.com/pulumi/pulumi-gcp/sdk/v9/go/gcp/storage"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
myProject, err := organizations.NewProject(ctx, "my_project", &organizations.ProjectArgs{
Name: pulumi.String("appeng-flex"),
ProjectId: pulumi.String("appeng-flex"),
OrgId: pulumi.String("123456789"),
BillingAccount: pulumi.String("000000-0000000-0000000-000000"),
DeletionPolicy: pulumi.String("DELETE"),
})
if err != nil {
return err
}
_, err = appengine.NewApplication(ctx, "app", &appengine.ApplicationArgs{
Project: myProject.ProjectId,
LocationId: pulumi.String("us-central"),
})
if err != nil {
return err
}
service, err := projects.NewService(ctx, "service", &projects.ServiceArgs{
Project: myProject.ProjectId,
Service: pulumi.String("appengineflex.googleapis.com"),
DisableDependentServices: pulumi.Bool(false),
})
if err != nil {
return err
}
customServiceAccount, err := serviceaccount.NewAccount(ctx, "custom_service_account", &serviceaccount.AccountArgs{
Project: service.Project,
AccountId: pulumi.String("my-account"),
DisplayName: pulumi.String("Custom Service Account"),
})
if err != nil {
return err
}
gaeApi, err := projects.NewIAMMember(ctx, "gae_api", &projects.IAMMemberArgs{
Project: service.Project,
Role: pulumi.String("roles/compute.networkUser"),
Member: customServiceAccount.Email.ApplyT(func(email string) (string, error) {
return fmt.Sprintf("serviceAccount:%v", email), nil
}).(pulumi.StringOutput),
})
if err != nil {
return err
}
_, err = projects.NewIAMMember(ctx, "logs_writer", &projects.IAMMemberArgs{
Project: service.Project,
Role: pulumi.String("roles/logging.logWriter"),
Member: customServiceAccount.Email.ApplyT(func(email string) (string, error) {
return fmt.Sprintf("serviceAccount:%v", email), nil
}).(pulumi.StringOutput),
})
if err != nil {
return err
}
_, err = projects.NewIAMMember(ctx, "storage_viewer", &projects.IAMMemberArgs{
Project: service.Project,
Role: pulumi.String("roles/storage.objectViewer"),
Member: customServiceAccount.Email.ApplyT(func(email string) (string, error) {
return fmt.Sprintf("serviceAccount:%v", email), nil
}).(pulumi.StringOutput),
})
if err != nil {
return err
}
bucket, err := storage.NewBucket(ctx, "bucket", &storage.BucketArgs{
Project: myProject.ProjectId,
Name: pulumi.String("appengine-static-content"),
Location: pulumi.String("US"),
})
if err != nil {
return err
}
object, err := storage.NewBucketObject(ctx, "object", &storage.BucketObjectArgs{
Name: pulumi.String("hello-world.zip"),
Bucket: bucket.Name,
Source: pulumi.NewFileAsset("./test-fixtures/hello-world.zip"),
})
if err != nil {
return err
}
_, err = appengine.NewFlexibleAppVersion(ctx, "myapp_v1", &appengine.FlexibleAppVersionArgs{
VersionId: pulumi.String("v1"),
Project: gaeApi.Project,
Service: pulumi.String("default"),
Runtime: pulumi.String("nodejs"),
FlexibleRuntimeSettings: &appengine.FlexibleAppVersionFlexibleRuntimeSettingsArgs{
OperatingSystem: pulumi.String("ubuntu24"),
RuntimeVersion: pulumi.String("24"),
},
Entrypoint: &appengine.FlexibleAppVersionEntrypointArgs{
Shell: pulumi.String("node ./app.js"),
},
Deployment: &appengine.FlexibleAppVersionDeploymentArgs{
Zip: &appengine.FlexibleAppVersionDeploymentZipArgs{
SourceUrl: pulumi.All(bucket.Name, object.Name).ApplyT(func(_args []interface{}) (string, error) {
bucketName := _args[0].(string)
objectName := _args[1].(string)
return fmt.Sprintf("https://storage.googleapis.com/%v/%v", bucketName, objectName), nil
}).(pulumi.StringOutput),
},
},
LivenessCheck: &appengine.FlexibleAppVersionLivenessCheckArgs{
Path: pulumi.String("/"),
},
ReadinessCheck: &appengine.FlexibleAppVersionReadinessCheckArgs{
Path: pulumi.String("/"),
},
EnvVariables: pulumi.StringMap{
"port": pulumi.String("8080"),
},
Handlers: appengine.FlexibleAppVersionHandlerArray{
&appengine.FlexibleAppVersionHandlerArgs{
UrlRegex: pulumi.String(".*\\/my-path\\/*"),
SecurityLevel: pulumi.String("SECURE_ALWAYS"),
Login: pulumi.String("LOGIN_REQUIRED"),
AuthFailAction: pulumi.String("AUTH_FAIL_ACTION_REDIRECT"),
StaticFiles: &appengine.FlexibleAppVersionHandlerStaticFilesArgs{
Path: pulumi.String("my-other-path"),
UploadPathRegex: pulumi.String(".*\\/my-path\\/*"),
},
},
},
AutomaticScaling: &appengine.FlexibleAppVersionAutomaticScalingArgs{
CoolDownPeriod: pulumi.String("120s"),
CpuUtilization: &appengine.FlexibleAppVersionAutomaticScalingCpuUtilizationArgs{
TargetUtilization: pulumi.Float64(0.5),
},
},
NoopOnDestroy: pulumi.Bool(true),
ServiceAccount: customServiceAccount.Email,
})
if err != nil {
return err
}
return nil
})
}
pulumi {
required_providers {
gcp = {
source = "pulumi/gcp"
}
}
}
resource "gcp_organizations_project" "my_project" {
name = "appeng-flex"
project_id = "appeng-flex"
org_id = "123456789"
billing_account = "000000-0000000-0000000-000000"
deletion_policy = "DELETE"
}
resource "gcp_appengine_application" "app" {
project = gcp_organizations_project.my_project.project_id
location_id = "us-central"
}
resource "gcp_projects_service" "service" {
project = gcp_organizations_project.my_project.project_id
service = "appengineflex.googleapis.com"
disable_dependent_services = false
}
resource "gcp_serviceaccount_account" "custom_service_account" {
project = gcp_projects_service.service.project
account_id = "my-account"
display_name = "Custom Service Account"
}
resource "gcp_projects_iammember" "gae_api" {
project = gcp_projects_service.service.project
role = "roles/compute.networkUser"
member ="serviceAccount:${gcp_serviceaccount_account.custom_service_account.email}"
}
resource "gcp_projects_iammember" "logs_writer" {
project = gcp_projects_service.service.project
role = "roles/logging.logWriter"
member ="serviceAccount:${gcp_serviceaccount_account.custom_service_account.email}"
}
resource "gcp_projects_iammember" "storage_viewer" {
project = gcp_projects_service.service.project
role = "roles/storage.objectViewer"
member ="serviceAccount:${gcp_serviceaccount_account.custom_service_account.email}"
}
resource "gcp_appengine_flexibleappversion" "myapp_v1" {
version_id = "v1"
project = gcp_projects_iammember.gae_api.project
service = "default"
runtime = "nodejs"
flexible_runtime_settings = {
operating_system = "ubuntu24"
runtime_version = "24"
}
entrypoint = {
shell = "node ./app.js"
}
deployment = {
zip = {
source_url ="https://storage.googleapis.com/${gcp_storage_bucket.bucket.name}/${gcp_storage_bucketobject.object.name}"
}
}
liveness_check = {
path = "/"
}
readiness_check = {
path = "/"
}
env_variables = {
"port" = "8080"
}
handlers {
url_regex = ".*\\/my-path\\/*"
security_level = "SECURE_ALWAYS"
login = "LOGIN_REQUIRED"
auth_fail_action = "AUTH_FAIL_ACTION_REDIRECT"
static_files = {
path = "my-other-path"
upload_path_regex = ".*\\/my-path\\/*"
}
}
automatic_scaling = {
cool_down_period = "120s"
cpu_utilization = {
target_utilization = 0.5
}
}
noop_on_destroy = true
service_account = gcp_serviceaccount_account.custom_service_account.email
}
resource "gcp_storage_bucket" "bucket" {
project = gcp_organizations_project.my_project.project_id
name = "appengine-static-content"
location = "US"
}
resource "gcp_storage_bucketobject" "object" {
name = "hello-world.zip"
bucket = gcp_storage_bucket.bucket.name
source = fileAsset("./test-fixtures/hello-world.zip")
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.organizations.Project;
import com.pulumi.gcp.organizations.ProjectArgs;
import com.pulumi.gcp.appengine.Application;
import com.pulumi.gcp.appengine.ApplicationArgs;
import com.pulumi.gcp.projects.Service;
import com.pulumi.gcp.projects.ServiceArgs;
import com.pulumi.gcp.serviceaccount.Account;
import com.pulumi.gcp.serviceaccount.AccountArgs;
import com.pulumi.gcp.projects.IAMMember;
import com.pulumi.gcp.projects.IAMMemberArgs;
import com.pulumi.gcp.storage.Bucket;
import com.pulumi.gcp.storage.BucketArgs;
import com.pulumi.gcp.storage.BucketObject;
import com.pulumi.gcp.storage.BucketObjectArgs;
import com.pulumi.gcp.appengine.FlexibleAppVersion;
import com.pulumi.gcp.appengine.FlexibleAppVersionArgs;
import com.pulumi.gcp.appengine.inputs.FlexibleAppVersionFlexibleRuntimeSettingsArgs;
import com.pulumi.gcp.appengine.inputs.FlexibleAppVersionEntrypointArgs;
import com.pulumi.gcp.appengine.inputs.FlexibleAppVersionDeploymentArgs;
import com.pulumi.gcp.appengine.inputs.FlexibleAppVersionDeploymentZipArgs;
import com.pulumi.gcp.appengine.inputs.FlexibleAppVersionLivenessCheckArgs;
import com.pulumi.gcp.appengine.inputs.FlexibleAppVersionReadinessCheckArgs;
import com.pulumi.gcp.appengine.inputs.FlexibleAppVersionHandlerArgs;
import com.pulumi.gcp.appengine.inputs.FlexibleAppVersionHandlerStaticFilesArgs;
import com.pulumi.gcp.appengine.inputs.FlexibleAppVersionAutomaticScalingArgs;
import com.pulumi.gcp.appengine.inputs.FlexibleAppVersionAutomaticScalingCpuUtilizationArgs;
import com.pulumi.asset.FileAsset;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var myProject = new Project("myProject", ProjectArgs.builder()
.name("appeng-flex")
.projectId("appeng-flex")
.orgId("123456789")
.billingAccount("000000-0000000-0000000-000000")
.deletionPolicy("DELETE")
.build());
var app = new Application("app", ApplicationArgs.builder()
.project(myProject.projectId())
.locationId("us-central")
.build());
var service = new Service("service", ServiceArgs.builder()
.project(myProject.projectId())
.service("appengineflex.googleapis.com")
.disableDependentServices(false)
.build());
var customServiceAccount = new Account("customServiceAccount", AccountArgs.builder()
.project(service.project())
.accountId("my-account")
.displayName("Custom Service Account")
.build());
var gaeApi = new IAMMember("gaeApi", IAMMemberArgs.builder()
.project(service.project())
.role("roles/compute.networkUser")
.member(customServiceAccount.email().applyValue(_email -> String.format("serviceAccount:%s", _email)))
.build());
var logsWriter = new IAMMember("logsWriter", IAMMemberArgs.builder()
.project(service.project())
.role("roles/logging.logWriter")
.member(customServiceAccount.email().applyValue(_email -> String.format("serviceAccount:%s", _email)))
.build());
var storageViewer = new IAMMember("storageViewer", IAMMemberArgs.builder()
.project(service.project())
.role("roles/storage.objectViewer")
.member(customServiceAccount.email().applyValue(_email -> String.format("serviceAccount:%s", _email)))
.build());
var bucket = new Bucket("bucket", BucketArgs.builder()
.project(myProject.projectId())
.name("appengine-static-content")
.location("US")
.build());
var object = new BucketObject("object", BucketObjectArgs.builder()
.name("hello-world.zip")
.bucket(bucket.name())
.source(new FileAsset("./test-fixtures/hello-world.zip"))
.build());
var myappV1 = new FlexibleAppVersion("myappV1", FlexibleAppVersionArgs.builder()
.versionId("v1")
.project(gaeApi.project())
.service("default")
.runtime("nodejs")
.flexibleRuntimeSettings(FlexibleAppVersionFlexibleRuntimeSettingsArgs.builder()
.operatingSystem("ubuntu24")
.runtimeVersion("24")
.build())
.entrypoint(FlexibleAppVersionEntrypointArgs.builder()
.shell("node ./app.js")
.build())
.deployment(FlexibleAppVersionDeploymentArgs.builder()
.zip(FlexibleAppVersionDeploymentZipArgs.builder()
.sourceUrl(Output.tuple(bucket.name(), object.name()).applyValue(values -> {
var bucketName = values.t1;
var objectName = values.t2;
return String.format("https://storage.googleapis.com/%s/%s", bucketName,objectName);
}))
.build())
.build())
.livenessCheck(FlexibleAppVersionLivenessCheckArgs.builder()
.path("/")
.build())
.readinessCheck(FlexibleAppVersionReadinessCheckArgs.builder()
.path("/")
.build())
.envVariables(Map.of("port", "8080"))
.handlers(FlexibleAppVersionHandlerArgs.builder()
.urlRegex(".*\\/my-path\\/*")
.securityLevel("SECURE_ALWAYS")
.login("LOGIN_REQUIRED")
.authFailAction("AUTH_FAIL_ACTION_REDIRECT")
.staticFiles(FlexibleAppVersionHandlerStaticFilesArgs.builder()
.path("my-other-path")
.uploadPathRegex(".*\\/my-path\\/*")
.build())
.build())
.automaticScaling(FlexibleAppVersionAutomaticScalingArgs.builder()
.coolDownPeriod("120s")
.cpuUtilization(FlexibleAppVersionAutomaticScalingCpuUtilizationArgs.builder()
.targetUtilization(0.5)
.build())
.build())
.noopOnDestroy(true)
.serviceAccount(customServiceAccount.email())
.build());
}
}
resources:
myProject:
type: gcp:organizations:Project
name: my_project
properties:
name: appeng-flex
projectId: appeng-flex
orgId: '123456789'
billingAccount: 000000-0000000-0000000-000000
deletionPolicy: DELETE
app:
type: gcp:appengine:Application
properties:
project: ${myProject.projectId}
locationId: us-central
service:
type: gcp:projects:Service
properties:
project: ${myProject.projectId}
service: appengineflex.googleapis.com
disableDependentServices: false
customServiceAccount:
type: gcp:serviceaccount:Account
name: custom_service_account
properties:
project: ${service.project}
accountId: my-account
displayName: Custom Service Account
gaeApi:
type: gcp:projects:IAMMember
name: gae_api
properties:
project: ${service.project}
role: roles/compute.networkUser
member: serviceAccount:${customServiceAccount.email}
logsWriter:
type: gcp:projects:IAMMember
name: logs_writer
properties:
project: ${service.project}
role: roles/logging.logWriter
member: serviceAccount:${customServiceAccount.email}
storageViewer:
type: gcp:projects:IAMMember
name: storage_viewer
properties:
project: ${service.project}
role: roles/storage.objectViewer
member: serviceAccount:${customServiceAccount.email}
myappV1:
type: gcp:appengine:FlexibleAppVersion
name: myapp_v1
properties:
versionId: v1
project: ${gaeApi.project}
service: default
runtime: nodejs
flexibleRuntimeSettings:
operatingSystem: ubuntu24
runtimeVersion: '24'
entrypoint:
shell: node ./app.js
deployment:
zip:
sourceUrl: https://storage.googleapis.com/${bucket.name}/${object.name}
livenessCheck:
path: /
readinessCheck:
path: /
envVariables:
port: '8080'
handlers:
- urlRegex: .*\/my-path\/*
securityLevel: SECURE_ALWAYS
login: LOGIN_REQUIRED
authFailAction: AUTH_FAIL_ACTION_REDIRECT
staticFiles:
path: my-other-path
uploadPathRegex: .*\/my-path\/*
automaticScaling:
coolDownPeriod: 120s
cpuUtilization:
targetUtilization: 0.5
noopOnDestroy: true
serviceAccount: ${customServiceAccount.email}
bucket:
type: gcp:storage:Bucket
properties:
project: ${myProject.projectId}
name: appengine-static-content
location: US
object:
type: gcp:storage:BucketObject
properties:
name: hello-world.zip
bucket: ${bucket.name}
source:
fn::fileAsset: ./test-fixtures/hello-world.zip
Import
FlexibleAppVersion can be imported using any of these accepted formats:
apps/{{project}}/services/{{service}}/versions/{{version_id}}{{project}}/{{service}}/{{version_id}}{{service}}/{{version_id}}
When using the pulumi import command, FlexibleAppVersion can be imported using one of the formats above. For example:
$ pulumi import gcp:appengine/flexibleAppVersion:FlexibleAppVersion default apps/{{project}}/services/{{service}}/versions/{{version_id}}
$ pulumi import gcp:appengine/flexibleAppVersion:FlexibleAppVersion default {{project}}/{{service}}/{{version_id}}
$ pulumi import gcp:appengine/flexibleAppVersion:FlexibleAppVersion default {{service}}/{{version_id}}
Constructors
- FlexibleAppVersion(String name, {FlexibleAppVersionArgs? args, CustomResourceOptions? options})
-
Creates a new FlexibleAppVersion.
nameThe Pulumi resource name.argsArguments used to configure this FlexibleAppVersion. The set of arguments for FlexibleAppVersion.optionsResource options controlling this resource's behavior. - FlexibleAppVersion.reference(String urn)
- Creates a typed reference to an existing FlexibleAppVersion resource.
Properties
-
apiConfig
↔ Output<
FlexibleAppVersionApiConfig?> -
Serving configuration for Google Cloud Endpoints.
Structure is documented below.
latefinal
-
automaticScaling
↔ Output<
FlexibleAppVersionAutomaticScaling?> -
Automatic scaling is based on request rate, response latencies, and other application metrics.
Structure is documented below.
latefinal
-
betaSettings
↔ Output<
Map< String, String> ?> -
Metadata settings that are supplied to this version to enable beta runtime features.
latefinal
-
childResources
→ Set<
Resource> -
finalinherited
-
completionSources
↔ Map<
String, IOutputCompletionSource> -
latefinalinherited
-
defaultExpiration
↔ Output<
String?> -
Duration that static files should be cached by web proxies and browsers.
Only applicable if the corresponding StaticFilesHandler does not specify its own expiration time.
latefinal
-
deleteServiceOnDestroy
↔ Output<
bool?> -
If set to
true, the service will be deleted if it is the last version.latefinal -
deletionPolicy
↔ Output<
String> -
Whether Terraform will be prevented from destroying the resource. Defaults to DELETE.
When a 'terraform destroy' or 'pulumi up' would delete the resource,
the command will fail if this field is set to "PREVENT" in Terraform state.
When set to "ABANDON", the command will remove the resource from Terraform
management without updating or deleting the resource in the API.
When set to "DELETE", deleting the resource is allowed.
latefinal
-
deployment
↔ Output<
FlexibleAppVersionDeployment?> -
Code and application artifacts that make up this version.
Structure is documented below.
latefinal
-
endpointsApiService
↔ Output<
FlexibleAppVersionEndpointsApiService?> -
Code and application artifacts that make up this version.
Structure is documented below.
latefinal
-
entrypoint
↔ Output<
FlexibleAppVersionEntrypoint?> -
The entrypoint for the application.
Structure is documented below.
latefinal
-
envVariables
↔ Output<
Map< String, String> ?> -
Environment variables available to the application. As these are not returned in the API request, the provider will not detect any changes made outside of the config.
latefinal
-
flexibleRuntimeSettings
↔ Output<
FlexibleAppVersionFlexibleRuntimeSettings?> -
Runtime settings for App Engine flexible environment.
Structure is documented below.
latefinal
-
handlers
↔ Output<
List< FlexibleAppVersionHandler> > -
An ordered list of URL-matching patterns that should be applied to incoming requests.
The first matching URL handles the request and other request handlers are not attempted.
Structure is documented below.
latefinal
- hashCode → int
-
The hash code for this object.
no setterinherited
-
id
↔ Output<
String> -
getter/setter pairinherited
-
inboundServices
↔ Output<
List< String> ?> -
A list of the types of messages that this application is able to receive.
Each value may be one of:
INBOUND_SERVICE_MAIL,INBOUND_SERVICE_MAIL_BOUNCE,INBOUND_SERVICE_XMPP_ERROR,INBOUND_SERVICE_XMPP_MESSAGE,INBOUND_SERVICE_XMPP_SUBSCRIBE,INBOUND_SERVICE_XMPP_PRESENCE,INBOUND_SERVICE_CHANNEL_PRESENCE,INBOUND_SERVICE_WARMUP.latefinal -
instanceClass
↔ Output<
String?> -
Instance class that is used to run this version. Valid values are
AutomaticScaling: F1, F2, F4, F4_1G
ManualScaling: B1, B2, B4, B8, B4_1G
Defaults to F1 for AutomaticScaling and B1 for ManualScaling.
latefinal
- isCustom → bool
-
Returns whether this resource is provider-managed.
no setterinherited
- isProtected → bool
-
Returns whether this resource is protected from deletion.
no setterinherited
- isRemote → bool
-
Whether this resource is registered as remote.
no setterinherited
- isResourceReference → bool
-
Whether this instance represents a resource value returned over RPC.
finalinherited
-
livenessCheck
↔ Output<
FlexibleAppVersionLivenessCheck> -
Health checking configuration for VM instances. Unhealthy instances are killed and replaced with new instances.
Structure is documented below.
latefinal
-
manualScaling
↔ Output<
FlexibleAppVersionManualScaling?> -
A service with manual scaling runs continuously, allowing you to perform complex initialization and rely on the state of its memory over time.
Structure is documented below.
latefinal
-
name
↔ Output<
String> -
Full path to the Version resource in the API. Example, "v1".
latefinal
-
network
↔ Output<
FlexibleAppVersionNetwork?> -
Extra network settings
Structure is documented below.
latefinal
-
nobuildFilesRegex
↔ Output<
String?> -
Files that match this pattern will not be built into this version. Only applicable for Go runtimes.
latefinal
-
noopOnDestroy
↔ Output<
bool?> -
If set to
true, the application version will not be deleted.latefinal -
project
↔ Output<
String> -
The ID of the project in which the resource belongs.
If it is not provided, the provider project is used.
latefinal
-
readinessCheck
↔ Output<
FlexibleAppVersionReadinessCheck> -
Configures readiness health checking for instances. Unhealthy instances are not put into the backend traffic rotation.
Structure is documented below.
latefinal
-
resources
↔ Output<
FlexibleAppVersionResources?> -
Machine resources for a version.
Structure is documented below.
latefinal
-
resourceTransforms
→ List<
ResourceTransform> -
Inherited/explicit async transforms.
no setterinherited
-
runtime
↔ Output<
String> -
Desired runtime. Example python27.
latefinal
-
runtimeApiVersion
↔ Output<
String> -
The version of the API in the given runtime environment.
Please see the app.yaml reference for valid values at
https://cloud.google.com/appengine/docs/standard/<language>/config/appref
Substitute<language>withpython,java,php,ruby,goornodejs.latefinal -
runtimeChannel
↔ Output<
String?> -
The channel of the runtime to use. Only available for some runtimes.
latefinal
-
runtimeMainExecutablePath
↔ Output<
String?> -
The path or name of the app's main executable.
latefinal
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
-
service
↔ Output<
String> -
AppEngine service resource. Can contain numbers, letters, and hyphens.
latefinal
-
serviceAccount
↔ Output<
String> -
The identity that the deployed version will run as. Admin API will use the App Engine Appspot service account as
default if this field is neither provided in app.yaml file nor through CLI flag.
latefinal
-
servingStatus
↔ Output<
String?> -
Current serving status of this version. Only the versions with a SERVING status create instances and can be billed.
Default value is
SERVING. Possible values are:SERVING,STOPPED.latefinal -
transformations
→ List<
ResourceTransformation> -
Inherited/explicit legacy transformations.
no setterinherited
-
urn
↔ Output<
String> -
latefinalinherited
-
versionId
↔ Output<
String?> -
Relative name of the version within the service. For example,
v1. Version names can contain only lowercase letters, numbers, or hyphens. Reserved names,"default", "latest", and any name with the prefix "ah-".latefinal -
vpcAccessConnector
↔ Output<
FlexibleAppVersionVpcAccessConnector?> -
Enables VPC connectivity for standard apps.
Structure is documented below.
latefinal
Methods
-
failId(
Object error) → void -
Completes this resource ID with an error when registration fails.
inherited
-
failOutputs(
Object error) → void -
Completes all output properties with
error.inherited -
failUrn(
Object error) → void -
Completes this resource URN with an error when registration fails.
inherited
-
getProvider(
String moduleMember) → ProviderResource? -
Returns provider for
moduleMember's package, if configured.inherited -
getResourceName(
) → String -
Returns this resource's logical name.
inherited
-
getResourceType(
) → String -
Returns this resource's Pulumi type token.
inherited
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
registerOutput<
T> (String propertyName, {Object? decoder(Object?)?, bool isSecret = false}) → Output< T> -
Registers a dynamic output property for this resource.
inherited
-
resolveId(
String? value, {required bool isKnown}) → void -
Resolves the provider-assigned ID for this resource.
inherited
-
resolveOutputs(
Struct outputs) → void -
Resolves all output properties from a monitor response payload.
inherited
-
resolveUrn(
String value) → void -
Resolves this resource's URN once assigned by the engine.
inherited
-
serializeProperties(
Map< String, dynamic> properties) → Future<Struct> -
Serializes resource properties for RPC transmission.
inherited
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited
Static Methods
-
get(
String name, Input< String> id, {FlexibleAppVersionState? state, CustomResourceOptions? options}) → FlexibleAppVersion -
Gets an existing FlexibleAppVersion resource's state with the given
nameandid.