{"id":13451572,"url":"https://github.com/submariner-io/submariner","last_synced_at":"2026-02-11T21:05:36.796Z","repository":{"id":37430897,"uuid":"175095528","full_name":"submariner-io/submariner","owner":"submariner-io","description":"Networking component for interconnecting Pods and Services across Kubernetes clusters.","archived":false,"fork":false,"pushed_at":"2025-05-12T15:45:37.000Z","size":10632,"stargazers_count":2511,"open_issues_count":36,"forks_count":190,"subscribers_count":55,"default_branch":"devel","last_synced_at":"2025-05-12T16:46:44.972Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://submariner.io","language":"Go","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/submariner-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE-OF-CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":"GOVERNANCE.md","roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-03-11T22:47:26.000Z","updated_at":"2025-05-12T12:00:12.000Z","dependencies_parsed_at":"2023-10-15T20:53:39.986Z","dependency_job_id":"287bb9d8-1a15-42da-8c4b-722b2227f90e","html_url":"https://github.com/submariner-io/submariner","commit_stats":{"total_commits":1975,"total_committers":53,"mean_commits":"37.264150943396224","dds":0.780759493670886,"last_synced_commit":"b1edc52299e01f6ccaad9c1c837e7d4b45b8bf91"},"previous_names":["rancher/submariner"],"tags_count":165,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/submariner-io%2Fsubmariner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/submariner-io%2Fsubmariner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/submariner-io%2Fsubmariner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/submariner-io%2Fsubmariner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/submariner-io","download_url":"https://codeload.github.com/submariner-io/submariner/tar.gz/refs/heads/devel","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254010822,"owners_count":21999003,"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","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-07-31T07:00:56.106Z","updated_at":"2026-02-11T21:05:36.766Z","avatar_url":"https://github.com/submariner-io.png","language":"Go","funding_links":[],"categories":["Go","Networking \u0026 Connectivity","others","Management"],"sub_categories":[],"readme":"# Submariner\n\n\u003c!-- markdownlint-disable line-length --\u003e\n[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/4865/badge)](https://bestpractices.coreinfrastructure.org/projects/4865)\n[![Release Images](https://github.com/submariner-io/submariner/workflows/Release%20Images/badge.svg)](https://github.com/submariner-io/submariner/actions?query=workflow%3A%22Release+Images%22)\n[![Periodic](https://github.com/submariner-io/submariner/workflows/Periodic/badge.svg)](https://github.com/submariner-io/submariner/actions?query=workflow%3APeriodic)\n[![Flake Finder](https://github.com/submariner-io/submariner/workflows/Flake%20Finder/badge.svg)](https://github.com/submariner-io/submariner/actions?query=workflow%3A%22Flake+Finder%22)\n\u003c!-- markdownlint-enable line-length --\u003e\n\n\u003c!-- START doctoc generated TOC please keep comment here to allow auto update --\u003e\n\u003c!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --\u003e\n\n- [Architecture](#architecture)\n  - [Network Path](#network-path)\n- [Prerequisites](#prerequisites)\n- [Installation](#installation)\n  - [Installation using subctl](#installation-using-subctl)\n  - [Installation using Helm](#installation-using-helm)\n  - [Validate Submariner is Working](#validate-submariner-is-working)\n- [Building and Testing](#building-and-testing)\n- [Known Issues](#known-issues)\n- [Contributing](#contributing)\n\n\u003c!-- END doctoc generated TOC please keep comment here to allow auto update --\u003e\n\nSubmariner is a tool built to connect overlay networks of different Kubernetes clusters.\nSubmariner is designed to be network plugin (CNI) agnostic and supports both encrypted and\nnon-encrypted tunnels between the connected clusters.\n\nNote that Submariner is in an early stage, and while we welcome usage and experimentation, it is quite possible that you could run into\nbugs.\n\nSubmariner is a Cloud Native Computing Foundation sandbox project.\n\n## Architecture\n\nSee the [Architecture section](https://submariner.io/getting-started/architecture/) of Submariner's website.\n\n### Network Path\n\nThe network path of Submariner varies depending on the origin/destination of the IP traffic. In all cases, traffic between two clusters will\ntransit between the leader elected (in each cluster) gateway nodes, through the configured cable driver.\n\nWhen the source Pod is on a worker node that is not the elected gateway node, the traffic destined for the remote cluster will transit\nthrough the submariner VXLAN tunnel (`vx-submariner`) to the local cluster gateway node.\nOn the gateway node, traffic is forwarded to the remote cluster over the configured tunnel.\nOnce the traffic reaches the destination gateway node, it is routed in one of two ways,\ndepending on the destination CIDR. If the destination CIDR is a Pod network, the traffic is routed via CNI-programmed network. If the\ndestination CIDR is a Service network, then traffic is routed through the facility configured via kube-proxy on the destination gateway\nnode.\n\n## Prerequisites\n\nSee the [Prerequisites docs](https://submariner.io/getting-started/#prerequisites) on Submariner's website.\n\n## Installation\n\nSubmariner is always deployed using a Go-based Kubernetes custom controller, called an\n[Operator](https://github.com/submariner-io/submariner-operator), that provides API-based installation and management. Deployment tools like\nthe *`subctl`* command line utility and Helm charts wrap the Operator. The recommended deployment method is `subctl`, as it is currently the\ndefault in CI and provides diagnostic features.\n\nSee the [Deplyment docs](https://submariner.io/operations/deployment/) on Submariner's website.\n\n### Installation using subctl\n\nSubmariner provides the `subctl` CLI utility to simplify the deployment and maintenance of Submariner across your clusters.\n\nSee the [`subctl` Deployment docs](https://submariner.io/operations/deployment/subctl/) on Submariner's website.\n\n### Installation using Helm\n\nSee the [Helm Deployment docs](https://submariner.io/operations/deployment/helm/) on Submariner's website.\n\n### Validate Submariner is Working\n\nSee the [`subctl verify` docs](https://submariner.io/operations/deployment/subctl/#verify) and [Automated\nTroubleshooting docs](https://submariner.io/operations/troubleshooting/#automated-troubleshooting) on Submariner's website.\n\n## Building and Testing\n\nSee the [Building and Testing docs](https://submariner.io/development/building-testing/) on Submariner's website.\n\n## Known Issues\n\nSee the [Known Issues docs](https://submariner.io/operations/known-issues/) on Submariner's website.\n\n## Contributing\n\nSee the [Development section](https://submariner.io/development/) of Submariner's website.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsubmariner-io%2Fsubmariner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsubmariner-io%2Fsubmariner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsubmariner-io%2Fsubmariner/lists"}