{"id":20761413,"url":"https://github.com/philips-labs/kong-on-hsdp","last_synced_at":"2026-06-10T09:31:25.316Z","repository":{"id":103438893,"uuid":"318174058","full_name":"philips-labs/kong-on-hsdp","owner":"philips-labs","description":"Example Terraform project which deploys a Kong API gateway to Cloud foundry","archived":false,"fork":false,"pushed_at":"2021-04-29T06:29:57.000Z","size":130,"stargazers_count":3,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-01T00:20:27.140Z","etag":null,"topics":["api-gateway","hsdp","kong","terraform"],"latest_commit_sha":null,"homepage":"","language":"HCL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/philips-labs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-12-03T11:40:22.000Z","updated_at":"2025-07-26T01:27:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"5e5ddb57-4953-4a23-a940-4a9dcb21c392","html_url":"https://github.com/philips-labs/kong-on-hsdp","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/philips-labs/kong-on-hsdp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philips-labs%2Fkong-on-hsdp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philips-labs%2Fkong-on-hsdp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philips-labs%2Fkong-on-hsdp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philips-labs%2Fkong-on-hsdp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/philips-labs","download_url":"https://codeload.github.com/philips-labs/kong-on-hsdp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philips-labs%2Fkong-on-hsdp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34146871,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["api-gateway","hsdp","kong","terraform"],"created_at":"2024-11-17T10:19:40.864Z","updated_at":"2026-06-10T09:31:25.264Z","avatar_url":"https://github.com/philips-labs.png","language":"HCL","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kong on HSDP\nThis Terraform root module demonstrates usage of a Kong API gateway\non HSDP Cloud foundry. We also spin up copy of the Konga UI Dashboard so you can interact with the Kong API gateway using your web browser.\n\nStart by cloning this repo somewhere:\n\n```shell\n$ git clone https://github.com/philips-labs/kong-on-hsdp.git\n...\n$ cd kong-on-hsdp\n```\n\n## What is being provisioned\n\n- PostgreSQL database\n- Kong API gateway\n- Konga Dashboard (internal)\n- Kong API Proxy endpoint with generated credentials\n\n## Installing Terraform\nTerraform should be installed on your system. [Instructions available here](https://learn.hashicorp.com/tutorials/terraform/install-cli). Once installed check the version, it should be at least `0.14.2` or higher:\n\n```shell\n$ terraform version\nTerraform v0.14.2\n```\n\n## Initalizing Terraform\nNext Terraform needs to download the necessary provider plugins, modules and set up the initial (empty) state. Start by executing\n\n```shell\n$ terraform init\n```\n\n## Configure variables\nThe default values for this project assume the following:\n* You have access to HSDP Cloud foundry HSDP Region `us-east`\n* You have `SpaceDeveloper` role to a CF Space\n\n### terraform.tfvars\nCreate a file called `terraform.tfvars` with the following lines:\n\n```hcl\ncf_org      = \"my-cf-org\"\ncf_space    = \"test-space\"\ncf_username = \"your_cf_username\"\ncf_password = \"your_cf_password\"\n```\n\n## terraform plan\nNow you are ready to run terraform [plan](https://www.terraform.io/docs/commands/plan.html):\n\n```shell\n$ terraform plan\n```\n\nTerraform will calculate an execution plan and display all the actions it needs to perform to deploy Kong and all its components.\n\n## terraform apply\nThe [apply](https://www.terraform.io/docs/commands/apply.html) step will kick off provisioning of all resources:\n\n```shell\n$ terraform apply\n```\n\nThis typically\ntakes between 5-15 minutes. The majority of the time is spend waiting on the PostgreSQL database to become available for use.\nOnce the apply step finishes you should see something like below:\n\n```shell\nApply complete! Resources: 15 added, 0 changed, 0 destroyed.\n\nOutputs:\n\nkong_gateway = \"https://kong-33483600f6a13c55.us-east.philips-healthsuite.com\"\nkong_api_username = \"33483600f6a13c55\"\nkong_api_password = \"RanomPassw0rdH3re\"\nkong_api_proxy = \"https://kong-api-33483600f6a13c55.us-east.philips-healthsuite.com\"\nkong_api_internal_endpoint = \"http://33483600f6a13c55.apps.internal:8001\"\n```\n## Accessing the Konga dashboard\nThe [Konga](https://github.com/pantsel/konga) dashboard UI is deployed as part of the module. It does not have a public route by default since there is no authentication mechanism in place. You can port forward the website to your local computer with the following command:\n\n```shell\n$ cf ssh -L 1337:localhost:1337 konga\n```\n\nOnce logged in you can navigate to [http://localhost:1337](http://localhost:1337) in your browser. Go to the `CONNECTIONS` section and add a new connection using the value of `kong_api_internal_endpoint` where it asks for the `Kong Admin URL`. If the output variables have scrolled off your screen you can always retrieve them again by running `terraform outputs`. Once entered you should see the Konga dashboard:\n\n![konga](resources/konga.png)\n\n# Next steps\n* Study the Kong module, fork it and try out some changes\n* Explore using the [Kong Terraform Provider](https://registry.terraform.io/providers/philips-labs/kong/latest) to manage Kong configuration\n* Join the HSDP Slack `#terraform` channel and share your experience\n\n## terraform destroy\nYou can remove all created resources using the terraform [destroy](https://www.terraform.io/docs/commands/destroy.html) command\n\n```shell\n$ terraform destroy\n```\n# Contact / Getting help\n\nandy.lo-a-foe@philips.com\n\n# License\n\nLicense is MIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphilips-labs%2Fkong-on-hsdp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphilips-labs%2Fkong-on-hsdp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphilips-labs%2Fkong-on-hsdp/lists"}