{"id":13846259,"url":"https://github.com/philips/backplane-kubernetes-ingress","last_synced_at":"2025-09-04T09:40:45.488Z","repository":{"id":66550386,"uuid":"90488454","full_name":"philips/backplane-kubernetes-ingress","owner":"philips","description":"prototype Kubernetes Ingress Controller for Backplane.io","archived":false,"fork":false,"pushed_at":"2017-05-06T22:11:32.000Z","size":297,"stargazers_count":28,"open_issues_count":0,"forks_count":2,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-14T03:42:58.711Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":null,"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.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}},"created_at":"2017-05-06T20:10:57.000Z","updated_at":"2017-06-29T05:43:09.000Z","dependencies_parsed_at":"2023-02-28T13:16:21.748Z","dependency_job_id":null,"html_url":"https://github.com/philips/backplane-kubernetes-ingress","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/philips/backplane-kubernetes-ingress","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philips%2Fbackplane-kubernetes-ingress","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philips%2Fbackplane-kubernetes-ingress/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philips%2Fbackplane-kubernetes-ingress/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philips%2Fbackplane-kubernetes-ingress/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/philips","download_url":"https://codeload.github.com/philips/backplane-kubernetes-ingress/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philips%2Fbackplane-kubernetes-ingress/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273586786,"owners_count":25132679,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-04T02:00:08.968Z","response_time":61,"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":[],"created_at":"2024-08-04T18:00:21.266Z","updated_at":"2025-09-04T09:40:45.422Z","avatar_url":"https://github.com/philips.png","language":null,"funding_links":[],"categories":["Operators vs Controllers"],"sub_categories":["Ingress"],"readme":"## Backplane.io Ingress Controller\n\nSimple setup to get [Backplane.io](https://www.backplane.io/) hooked up as a Kubernetes Ingress Controller. This makes it possible to do things like have a publicly available load balancer from a behind-the-firewall install with say [Tectonic Bare-metal](https://coreos.com/tectonic) or [minikube](https://github.com/kubernetes/minikube).\n\n## Setup Backplane Ingress Controller\n\nSetup the Backplane secret:\n\n```\nexport BACKPLANE_TOKEN=SECRETS_GO_HERE\nkubectl create secret -n kube-system generic backplane-token --from-literal=bptoken=${BACKPLANE_TOKEN}\n```\n\nConfigure any backplane labels, importantly the endpoint:\n\n```\nkubectl create configmap backplane-config -n kube-system --from-literal=labels=endpoint=patient-spark-20.backplaneapp.io,release=v1\n```\n\nDeploy backplane Ingress and a default 404 page\n\n```\nkubectl create -f https://raw.githubusercontent.com/philips/backplane-kubernetes-ingress/master/ingress-controller.yaml\nkubectl create -f https://raw.githubusercontent.com/kubernetes/ingress/master/examples/deployment/nginx/default-backend.yaml\n```\n\nIf all goes well the [Backplane Dashboard](https://www.backplane.io/dashboard) should show a single backend.\n\n![screenshot of dashboard](Documentation/imgs/bp.png)\n\n\n## Debugging Logs\n\nNGINX:\n\n```\nkubectl get pods --namespace=kube-system -l k8s-app=backplane-ingress-controller -o jsonpath='{range .items[*]}{.metadata.name}{\"\\n\"}{end}' | xargs -I {} kubectl -n kube-system -c nginx-ingress-controller logs {}\n```\n\nBackplane Agent:\n\n```\nkubectl get pods --namespace=kube-system -l k8s-app=backplane-ingress-controller -o jsonpath='{range .items[*]}{.metadata.name}{\"\\n\"}{end}' | xargs -I {} kubectl -n kube-system -c bpagent logs {}\n```\n\n## Deploy an App w/ Ingress\n\n```\nkubectl run --image=quay.io/philips/host-info:latest host-info\nkubectl expose deployment host-info --session-affinity=None --port 8080\nkubectl create -f https://raw.githubusercontent.com/philips/host-info/master/ingress.yaml\n```\n\n## Scaling\n\nAdding additional backends is as simple as scaling the deployment:\n\n```\nkubectl scale deployments backplane-ingress-controller -n kube-system --replicas=3\n```\n\n![screenshot of labels](Documentation/imgs/scale.png)\n\n## Future Work\n\n- Make a native Backplane Ingress controller instead of relying on nginx see https://github.com/kubernetes/ingress/tree/master/examples/custom-controller\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphilips%2Fbackplane-kubernetes-ingress","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphilips%2Fbackplane-kubernetes-ingress","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphilips%2Fbackplane-kubernetes-ingress/lists"}