{"id":16183581,"url":"https://github.com/terraform-ibm-modules/terraform-ibm-enterprise-app-java","last_synced_at":"2026-02-21T06:16:18.159Z","repository":{"id":249833198,"uuid":"832695526","full_name":"terraform-ibm-modules/terraform-ibm-enterprise-app-java","owner":"terraform-ibm-modules","description":"Provisions and configures a Liberty as a Service instance into an IBM Cloud account.","archived":false,"fork":false,"pushed_at":"2026-02-17T14:36:16.000Z","size":423,"stargazers_count":0,"open_issues_count":6,"forks_count":2,"subscribers_count":13,"default_branch":"main","last_synced_at":"2026-02-17T18:59:16.148Z","etag":null,"topics":["core-team","deployable-architecture","enterprise-app-java","ibm-cloud","terraform","terraform-module"],"latest_commit_sha":null,"homepage":null,"language":"HCL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/terraform-ibm-modules.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-07-23T14:35:18.000Z","updated_at":"2026-02-17T18:56:41.000Z","dependencies_parsed_at":"2024-11-06T17:24:43.768Z","dependency_job_id":"14689f0f-8e1c-4f9e-8b7d-d6069572b3ee","html_url":"https://github.com/terraform-ibm-modules/terraform-ibm-enterprise-app-java","commit_stats":{"total_commits":18,"total_committers":6,"mean_commits":3.0,"dds":0.4444444444444444,"last_synced_commit":"7de7b0227940ab3faa01526ede793407327b32a5"},"previous_names":["terraform-ibm-modules/terraform-ibm-liberty-aas","terraform-ibm-modules/terraform-ibm-ease"],"tags_count":79,"template":false,"template_full_name":"terraform-ibm-modules/terraform-ibm-module-template","purl":"pkg:github/terraform-ibm-modules/terraform-ibm-enterprise-app-java","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terraform-ibm-modules%2Fterraform-ibm-enterprise-app-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terraform-ibm-modules%2Fterraform-ibm-enterprise-app-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terraform-ibm-modules%2Fterraform-ibm-enterprise-app-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terraform-ibm-modules%2Fterraform-ibm-enterprise-app-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/terraform-ibm-modules","download_url":"https://codeload.github.com/terraform-ibm-modules/terraform-ibm-enterprise-app-java/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terraform-ibm-modules%2Fterraform-ibm-enterprise-app-java/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29675072,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T05:54:28.202Z","status":"ssl_error","status_checked_at":"2026-02-21T05:53:42.585Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["core-team","deployable-architecture","enterprise-app-java","ibm-cloud","terraform","terraform-module"],"created_at":"2024-10-10T07:01:49.288Z","updated_at":"2026-02-21T06:16:18.133Z","avatar_url":"https://github.com/terraform-ibm-modules.png","language":"HCL","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- Update this title with a descriptive name. Use sentence case. --\u003e\n# Enterprise Application Service for Java\n\n\u003c!--\nUpdate status and \"latest release\" badges:\n  1. For the status options, see https://terraform-ibm-modules.github.io/documentation/#/badge-status\n  2. Update the \"latest release\" badge to point to the correct module's repo. Replace \"terraform-ibm-module-template\" in two places.\n--\u003e\n[![Graduated (Supported)](https://img.shields.io/badge/status-Graduated%20(Supported)-brightgreen?style=plastic)](https://terraform-ibm-modules.github.io/documentation/#/badge-status)\n[![latest release](https://img.shields.io/github/v/release/terraform-ibm-modules/terraform-ibm-enterprise-app-java?logo=GitHub\u0026sort=semver)](https://github.com/terraform-ibm-modules/terraform-ibm-enterprise-app-java/releases/latest)\n[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit\u0026logoColor=white)](https://github.com/pre-commit/pre-commit)\n[![Renovate enabled](https://img.shields.io/badge/renovate-enabled-brightgreen.svg)](https://renovatebot.com/)\n[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)\n\n\u003c!--\nAdd a description of modules in this repo.\nExpand on the repo short description in the .github/settings.yml file.\n\nFor information, see \"Module names and descriptions\" at\nhttps://terraform-ibm-modules.github.io/documentation/#/implementation-guidelines?id=module-names-and-descriptions\n--\u003e\n\nUse this module to provision and configure an [Enterprise Application Service](https://cloud.ibm.com/catalog/services/enterprise-application-service) (also shorthened to EASeJava or simply to `ease`) instance on IBM Cloud.\n\nFor more information about the Enterprise Application Service product you can refer to the [product documentation](https://www.ibm.com/docs/en/ease?topic=overview)\n\n\n\u003c!-- The following content is automatically populated by the pre-commit hook --\u003e\n\u003c!-- BEGIN OVERVIEW HOOK --\u003e\n## Overview\n* [terraform-ibm-enterprise-app-java](#terraform-ibm-enterprise-app-java)\n* [Examples](./examples)\n    * \u003cdiv style=\"display: inline-block;\"\u003e\u003ca href=\"./examples/basic\"\u003eBasic example\u003c/a\u003e\u003c/div\u003e \u003cdiv style=\"display: inline-block; vertical-align: middle;\"\u003e\u003ca href=\"https://cloud.ibm.com/schematics/workspaces/create?workspace_name=eaj-basic-example\u0026repository=https://github.com/terraform-ibm-modules/terraform-ibm-enterprise-app-java/tree/main/examples/basic\" target=\"_blank\"\u003e\u003cimg src=\"https://cloud.ibm.com/media/docs/images/icons/Deploy_to_cloud.svg\" alt=\"Deploy to IBM Cloud button\"\u003e\u003c/a\u003e\u003c/div\u003e\n    * \u003cdiv style=\"display: inline-block;\"\u003e\u003ca href=\"./examples/bdr_complete\"\u003eBuild, deploy and run complete example\u003c/a\u003e\u003c/div\u003e \u003cdiv style=\"display: inline-block; vertical-align: middle;\"\u003e\u003ca href=\"https://cloud.ibm.com/schematics/workspaces/create?workspace_name=eaj-bdr_complete-example\u0026repository=https://github.com/terraform-ibm-modules/terraform-ibm-enterprise-app-java/tree/main/examples/bdr_complete\" target=\"_blank\"\u003e\u003cimg src=\"https://cloud.ibm.com/media/docs/images/icons/Deploy_to_cloud.svg\" alt=\"Deploy to IBM Cloud button\"\u003e\u003c/a\u003e\u003c/div\u003e\n    * \u003cdiv style=\"display: inline-block;\"\u003e\u003ca href=\"./examples/dr_complete\"\u003eDeploy and run complete example\u003c/a\u003e\u003c/div\u003e \u003cdiv style=\"display: inline-block; vertical-align: middle;\"\u003e\u003ca href=\"https://cloud.ibm.com/schematics/workspaces/create?workspace_name=eaj-dr_complete-example\u0026repository=https://github.com/terraform-ibm-modules/terraform-ibm-enterprise-app-java/tree/main/examples/dr_complete\" target=\"_blank\"\u003e\u003cimg src=\"https://cloud.ibm.com/media/docs/images/icons/Deploy_to_cloud.svg\" alt=\"Deploy to IBM Cloud button\"\u003e\u003c/a\u003e\u003c/div\u003e\n* [Contributing](#contributing)\n\u003c!-- END OVERVIEW HOOK --\u003e\n\n\n\u003c!--\nIf this repo contains any reference architectures, uncomment the heading below and link to them.\n(Usually in the `/reference-architectures` directory.)\nSee \"Reference architecture\" in the public documentation at\nhttps://terraform-ibm-modules.github.io/documentation/#/implementation-guidelines?id=reference-architecture\n--\u003e\n\u003c!-- ## Reference architectures --\u003e\n\n## Enterprise Application Service use cases support\n\nThis module supports both the use cases provided by the Enterprise Application Service:\n- **Deploy and Run your application** use case: you can provide your existing prebuilt enterprise archive (EAR) or web archive (WAR) file in a Maven artifact repository, the service will allow to deploy and to run it.\n- **Build, deploy and run your application** use case: you can provide your application source code through its GitHub repository URL, the service will allow to build, deploy and then run it.\n\nFor more details about the two different use-cases and the input parameters to use please refer to the sections below.\n\n### Mandatory input parameters for both the use cases\n\nBoth the use-cases supported by this module need you to specify the following parameters as mandatory inputs.\n\n1. The IBM Cloud API Key (https://cloud.ibm.com/iam/apikeys) for the account where to deploy the Enterprise Application Service instance\n1. Resource Group ID (https://cloud.ibm.com/account/resource-groups) containing the Enterprise Application Service instance\n\n## Deploy and Run use case input parameters\n\nThe following optional input parameters are required in order to pre-configure the Enterprise Application Service instance for the Deploy and Run use case:\n\n1. URL of the Maven artifact repository storing the existing prebuilt enterprise archive (EAR) or web archive (WAR) file to run in the Enterprise Application Service instance\n   1. If your Maven artifact repository needs basic authentication, you can specify the username and password using the related input variables. If the repository doesn't need authentication, you can leave them to their default values.\n2. URL of the GitHub repository storing the application deployment configuration to run in the Enterprise Application Service instance\n3. GitHub token with read access to the configuration repository.\n\n**Note:** all these parameters (excluding the Maven repository username and password) are mandatory in the case any of them is different than their default null value (the GitHub token is mandatory also if the configuration repository is public). When all of them are left to the default null value it will be possible to configure the instance with their values once the instance is successfully created, as describe [here](#create-an-enterprise-application-service-instance-without-setting-any-repository)\n\nThe GitHub configuration repository must satisfy a further prerequisite as described [here](#ibm-appflow-github-application-prerequisite)\n\nFor more details about this use-case please refer to the Enterprise Application Service product documentation section available [here](https://www.ibm.com/docs/en/ease?topic=deploy-run-your-application-option)\n\n### Build, Deploy and Run use case input parameters\n\nThe following optional input parameters are required in order to pre-configure the Enterprise Application Service instance for the Build, deploy and run use case:\n\n1. URL of the GitHub repository storing your application source code to Build, deploy and run in the Enterprise Application Service instance\n1. URL of the GitHub repository storing your application configuration to Build, deploy and run in the Enterprise Application Service instance\n1. GitHub token with read access the source code and configuration repositories.\n\n**Note:** all these parameters are mandatory in the case any of them is different than their default null value (the GitHub token is mandatory also if both the repositories are public). When all of them are left to the default null value it will be possible to configure the instance with their values once the instance is successfully created, as describe [here](#create-an-enterprise-application-service-instance-without-setting-any-repository)\n\nBoth the repositories must satisfy a further prerequisite as described [here](#ibm-appflow-github-application-prerequisite)\n\nFor more details about this use-case please refer to the Enterprise Application Service product documentation section available [here](https://www.ibm.com/docs/en/ease?topic=build-deploy-run-your-application-option)\n\n#### IBM AppFlow GitHub application prerequisite\n\nIn order to configure the Enterprise Application Service instance to build the Java liberty application using the source code and the configuration repositories, the GitHub application **IBM AppFlow** must installed in the GitHub organization(s) hosting the repositories and enable to access both of them.\n\nTo install and configure the **IBM AppFlow** GitHub application refer to https://github.com/apps/ibm-enterprise-application-service\n\n**Note:** in the case you need to configure an Enterprise Application Service instance in an environment different from IBM Cloud public platform, you need to install and configure a specific version of the **IBM AppFlow** GitHub application.\n\n### Create an Enterprise Application Service instance without setting any repository\n\nThis module also supports to create an instance of the Enterprise Application Service without setting any source (GitHub or Maven) and configuration repository: in this case it will be possible to configure them through the Enterprise Application Service dashboard accessible through the dashboard URL returned in the `ease_instance` output details of this module.\n\n### Java liberty sample application\n\nFor an example of source code and configuration repositories to Build, deploy and run in an Enterprise Application Service instance you can fork the repositories below:\n\n- source code repository: https://github.com/IBMAppFlowTest/sample-getting-started\n\n- configuration repository: https://github.com/IBMAppFlowTest/sample-getting-started-config\n\n\u003c!-- Replace this heading with the name of the root level module (the repo name) --\u003e\n## terraform-ibm-enterprise-app-java\n\n### Usage\n\n\u003c!--\nAdd an example of the use of the module in the following code block.\n\nUse real values instead of \"var.\u003cvar_name\u003e\" or other placeholder values\nunless real values don't help users know what to change.\n--\u003e\n\n```hcl\nprovider \"ibm\" {\n  ibmcloud_api_key = \"XXXXXXXXXX\" \u003c!-- pragma: allowlist secret --\u003e\n}\n\nmodule \"ease_module\" {\n  # Replace \"master\" with a GIT release version to lock into a specific release\n  source           = \"git::https://github.com/terraform-ibm-modules/terraform-ibm-enterprise-app-java.git?ref=master\"\n  ease_name         = \"your-ease-app-name\"\n  resource_group_id = module.resource_group.resource_group_id\n  tags              = var.resource_tags\n  plan              = var.plan\n  region            = var.region\n  config_repo       = var.config_repo\n  source_repo       = var.source_repo\n  repos_git_token   = var.repos_git_token \u003c!-- pragma: allowlist secret --\u003e\n}\n```\n\n### Required IAM access policies\n\nYou need the following permissions to run this module:\n\n- IAM services\n    - **enterprise-application-service** service\n        - `Editor` platform access\n\n\u003c!-- The following content is automatically populated by the pre-commit hook --\u003e\n\u003c!-- BEGINNING OF PRE-COMMIT-TERRAFORM DOCS HOOK --\u003e\n### Requirements\n\n| Name | Version |\n|------|---------|\n| \u003ca name=\"requirement_terraform\"\u003e\u003c/a\u003e [terraform](#requirement\\_terraform) | \u003e= 1.9.0 |\n| \u003ca name=\"requirement_ibm\"\u003e\u003c/a\u003e [ibm](#requirement\\_ibm) | \u003e= 1.67.0, \u003c 2.0.0 |\n\n### Modules\n\nNo modules.\n\n### Resources\n\n| Name | Type |\n|------|------|\n| [ibm_resource_instance.ease_instance](https://registry.terraform.io/providers/ibm-cloud/ibm/latest/docs/resources/resource_instance) | resource |\n\n### Inputs\n\n| Name | Description | Type | Default | Required |\n|------|-------------|------|---------|:--------:|\n| \u003ca name=\"input_config_repo\"\u003e\u003c/a\u003e [config\\_repo](#input\\_config\\_repo) | The URL for the repository storing the configuration to use for the application to run through Enterprise Application Service on IBM Cloud. | `string` | `null` | no |\n| \u003ca name=\"input_ease_name\"\u003e\u003c/a\u003e [ease\\_name](#input\\_ease\\_name) | The name for the newly provisioned Enterprise Application Service instance. If a prefix input variable is specified, the prefix is added to the name in the `\u003cprefix\u003e-\u003cname\u003e` format. | `string` | `\"instance\"` | no |\n| \u003ca name=\"input_maven_repository_password\"\u003e\u003c/a\u003e [maven\\_repository\\_password](#input\\_maven\\_repository\\_password) | Maven repository authentication password if needed. Default to null. | `string` | `null` | no |\n| \u003ca name=\"input_maven_repository_username\"\u003e\u003c/a\u003e [maven\\_repository\\_username](#input\\_maven\\_repository\\_username) | Maven repository authentication username if needed. Default to null. | `string` | `null` | no |\n| \u003ca name=\"input_plan\"\u003e\u003c/a\u003e [plan](#input\\_plan) | The desired pricing plan for Enterprise Application Service instance. | `string` | `\"standard\"` | no |\n| \u003ca name=\"input_region\"\u003e\u003c/a\u003e [region](#input\\_region) | The desired region for deploying Enterprise Application Service instance. | `string` | `\"us-east\"` | no |\n| \u003ca name=\"input_repos_git_token\"\u003e\u003c/a\u003e [repos\\_git\\_token](#input\\_repos\\_git\\_token) | The GitHub token to read from the application and configuration repositories. It cannot be null if var.source\\_repo and var.config\\_repo are not null. | `string` | `null` | no |\n| \u003ca name=\"input_resource_group_id\"\u003e\u003c/a\u003e [resource\\_group\\_id](#input\\_resource\\_group\\_id) | The ID of the resource group to use for the creation of the Enterprise Application Service instance. | `string` | n/a | yes |\n| \u003ca name=\"input_source_repo\"\u003e\u003c/a\u003e [source\\_repo](#input\\_source\\_repo) | The URL for the repository storing the source code of the application or the URL of the Maven artifact repository storing the existing prebuilt archive (WAR or EAR) to deploy and run through Enterprise Application Service on IBM Cloud. | `string` | `null` | no |\n| \u003ca name=\"input_source_repo_type\"\u003e\u003c/a\u003e [source\\_repo\\_type](#input\\_source\\_repo\\_type) | Type of the source code repository. For maven source repository type, use value `maven`. Git for GitHub repository. Default value set to git. | `string` | `\"git\"` | no |\n| \u003ca name=\"input_subscription_id\"\u003e\u003c/a\u003e [subscription\\_id](#input\\_subscription\\_id) | ID of the subscription to use to create the Enterprise Application Service instance. | `string` | n/a | yes |\n| \u003ca name=\"input_tags\"\u003e\u003c/a\u003e [tags](#input\\_tags) | Metadata labels describing the service instance, i.e. test | `list(string)` | `[]` | no |\n\n### Outputs\n\n| Name | Description |\n|------|-------------|\n| \u003ca name=\"output_ease_instance\"\u003e\u003c/a\u003e [ease\\_instance](#output\\_ease\\_instance) | Enterprise Application Service instance details |\n\u003c!-- END OF PRE-COMMIT-TERRAFORM DOCS HOOK --\u003e\n\n\u003c!-- Leave this section as is so that your module has a link to local development environment set-up steps for contributors to follow --\u003e\n## Contributing\n\nYou can report issues and request features for this module in GitHub issues in the module repo. See [Report an issue or request a feature](https://github.com/terraform-ibm-modules/.github/blob/main/.github/SUPPORT.md).\n\nTo set up your local development environment, see [Local development setup](https://terraform-ibm-modules.github.io/documentation/#/local-dev-setup) in the project documentation.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fterraform-ibm-modules%2Fterraform-ibm-enterprise-app-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fterraform-ibm-modules%2Fterraform-ibm-enterprise-app-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fterraform-ibm-modules%2Fterraform-ibm-enterprise-app-java/lists"}