terraform-provider-google/website/docs/r/app_engine_application.html.markdown

78 lines
2.7 KiB
Markdown
Raw Normal View History

---
layout: "google"
page_title: "Google: google_app_engine_application"
sidebar_current: "docs-google-app-engine-application"
description: |-
Allows management of an App Engine application.
---
# google\_app_engine_application
Allows creation and management of an App Engine application.
~> App Engine applications cannot be deleted once they're created; you have to delete the
entire project to delete the application. Terraform will force you to set the `ack_delete_noop`
field to `true` to acknowledge this limitation before you can successfully delete an App Engine
application. There's no harm in leaving the `ack_delete_noop` field set to true at all times.
## Example Usage
```hcl
resource "google_project" "my_project" {
name = "My Project"
project_id = "your-project-id"
org_id = "1234567"
}
resource "google_app_engine_application" "app" {
project = "${google_project.my_project.project_id}"
location_id = "us-central'
ack_delete_noop = true
}
```
## Argument Reference
The following arguments are supported:
* `location_id` - (Required) The [location](https://cloud.google.com/appengine/docs/locations)
to serve the app from.
* `ack_delete_noop` - (Optional) Set to true to allow Terraform to "delete" your application without error.
Has no bearing except to indicate that you're aware that when Terraform says it deletes an application,
the application has not actually been deleted. To delete an application, the entire project must be deleted.
* `auth_domain` - (Optional) The domain to authenticate users with when using App Engine's User API.
* `serving_status` - (Optional) The serving status of the app. Note that this can't be updated at the moment.
* `feature_settings` - (Optional) A block of optional settings to configure specific App Engine features:
* `split_health_checks` - (Optional) Set to false to use the legacy health check instead of the readiness
and liveness checks.
## Attributes Reference
In addition to the arguments listed above, the following computed attributes are
exported:
* `name` - Unique name of the app, usually `apps/{PROJECT_ID}`
* `url_dispatch_rule` - A list of dispatch rule blocks. Each block has a `domain`, `path`, and `service` field.
* `code_bucket` - The GCS bucket code is being stored in for this app.
* `default_hostname` - The default hostname for this app.
* `default_bucket` - The GCS bucket content is being stored in for this app.
* `gcr_domain` - The GCR domain used for storing managed Docker images for this app.
## Import
Applications can be imported using the ID of the project the application belongs to, e.g.
```
$ terraform import google_app_engine_application.app your-project-id
```