{"id":13561255,"url":"https://github.com/istio-ecosystem/admiral","last_synced_at":"2026-03-09T12:52:19.816Z","repository":{"id":37925472,"uuid":"203845904","full_name":"istio-ecosystem/admiral","owner":"istio-ecosystem","description":"Admiral provides automatic configuration generation, syncing and service discovery for multicluster Istio service mesh","archived":false,"fork":false,"pushed_at":"2025-10-15T17:58:17.000Z","size":31236,"stargazers_count":628,"open_issues_count":21,"forks_count":87,"subscribers_count":24,"default_branch":"master","last_synced_at":"2025-10-16T12:17:00.086Z","etag":null,"topics":["admiral","automation","clusters","configuration","istio","k8s","microservices","multi-cluster","multicluster","service-discovery","service-mesh"],"latest_commit_sha":null,"homepage":"","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/istio-ecosystem.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":".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":"2019-08-22T17:53:04.000Z","updated_at":"2025-10-15T15:05:13.000Z","dependencies_parsed_at":"2023-02-18T11:04:01.520Z","dependency_job_id":"ee199eac-46e1-4993-bc0b-9017749a2864","html_url":"https://github.com/istio-ecosystem/admiral","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/istio-ecosystem/admiral","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/istio-ecosystem%2Fadmiral","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/istio-ecosystem%2Fadmiral/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/istio-ecosystem%2Fadmiral/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/istio-ecosystem%2Fadmiral/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/istio-ecosystem","download_url":"https://codeload.github.com/istio-ecosystem/admiral/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/istio-ecosystem%2Fadmiral/sbom","scorecard":{"id":496327,"data":{"date":"2025-08-11","repo":{"name":"github.com/istio-ecosystem/admiral","commit":"797d1e24fc5f06cb3d252d0fef8db1cf072f2579"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.6,"checks":[{"name":"Code-Review","score":9,"reason":"Found 19/20 approved changesets -- score normalized to 9","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Maintained","score":7,"reason":"9 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 7","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v1.2 not signed: https://api.github.com/repos/istio-ecosystem/admiral/releases/57944838","Warn: release artifact v1.1 not signed: https://api.github.com/repos/istio-ecosystem/admiral/releases/34299035","Warn: release artifact v1.0 not signed: https://api.github.com/repos/istio-ecosystem/admiral/releases/30181536","Warn: release artifact v1.2 does not have provenance: https://api.github.com/repos/istio-ecosystem/admiral/releases/57944838","Warn: release artifact v1.1 does not have provenance: https://api.github.com/repos/istio-ecosystem/admiral/releases/34299035","Warn: release artifact v1.0 does not have provenance: https://api.github.com/repos/istio-ecosystem/admiral/releases/30181536"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: containerImage not pinned by hash: admiral/docker/Dockerfile.admiral:1: pin your Docker image by updating ubuntu:focal to ubuntu:focal@sha256:8feb4d8ca5354def3d8fce243717141ce31e2c428701f6682bd2fafe15388214","Info:   0 out of   1 containerImage dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 30 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":4,"reason":"6 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GO-2022-0635","Warn: Project is vulnerable to: GO-2022-0646","Warn: Project is vulnerable to: GO-2024-3333","Warn: Project is vulnerable to: GO-2025-3503 / GHSA-qxp5-gwg8-xv66","Warn: Project is vulnerable to: GO-2025-3595 / GHSA-vvgc-356p-c3xw","Warn: Project is vulnerable to: GO-2025-3488 / GHSA-6v2p-p543-phr9"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-19T20:30:00.157Z","repository_id":37925472,"created_at":"2025-08-19T20:30:00.157Z","updated_at":"2025-08-19T20:30:00.157Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30297040,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-09T11:12:22.024Z","status":"ssl_error","status_checked_at":"2026-03-09T11:10:54.577Z","response_time":61,"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":["admiral","automation","clusters","configuration","istio","k8s","microservices","multi-cluster","multicluster","service-discovery","service-mesh"],"created_at":"2024-08-01T13:00:54.188Z","updated_at":"2026-03-09T12:52:18.287Z","avatar_url":"https://github.com/istio-ecosystem.png","language":"Go","funding_links":[],"categories":["Go","Install from Source","Service Discovery \u0026 Registry","Configuration"],"sub_categories":["Service Discovery"],"readme":"\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/35096265/65359707-33216900-dbb2-11e9-8622-dc76c3882c02.png\" width=\"500\"\u003e\n\u003c/p\u003e\n\n\n[//]: # (Build Status)\n\n[![CircleCI](https://circleci.com/gh/istio-ecosystem/admiral/tree/master.svg?style=svg)](https://circleci.com/gh/istio-ecosystem/admiral/tree/master)\n\n[//]: # (Code Coverage)\n\n[![codecov](https://codecov.io/gh/istio-ecosystem/admiral/branch/master/graph/badge.svg)](https://codecov.io/gh/istio-ecosystem/admiral)\n\n[//]: # (usage)\n\n**Admiral provides automatic configuration and service discovery for multicluster Istio service mesh**\n\nIstio has a very robust set of multi-cluster capabilities.  Managing this configuration across multiple clusters at scale is challenging.  Admiral takes an opinionated view on this configuration and provides automatic provisioning and syncing across clusters.\n\nAdmiral defines two custom resources, the [Dependency](./docs/Architecture.md#dependency) and [GlobalTrafficPolicy](./docs/Architecture.md#global-traffic-policy), which are used to configure ServiceEntries, VirtualServices, and DestinationRules on each cluster for each cross-cluster service. This removes the complexity for developers and mesh operators.\n\n![alt text](./docs/diagrams/admiral.svg)\n\n[Admiral Demo](https://www.youtube.com/watch?v=cwQpt1t287c)\n\n## [Docs](./docs/Index.md)\n\n## Who uses Admiral?\n\nOrganizations below are **officially** using Admiral. Please send a PR with your organization name if you are using Admiral.\n\n* [Intuit](https://www.intuit.com/)\n\n## Blogs and Presentations\n\n* [Multicluster Istio configuration and service discovery using Admiral](https://istio.io/blog/2020/multi-cluster-mesh-automation/)\n\n* [Stitching a Service Mesh Across Hundreds of Discrete Networks](https://www.youtube.com/watch?v=EWyNbBn1vns)\n\n* [Scaling Service Mesh to an Enterprise Microservices Ecosystem](https://apiworld2019aidevworld2019.sched.com/event/SLIQ/pro-talk-scaling-service-mesh-to-an-enterprise-microservices-ecosystem)\n\n* [Admiral – Enabling Multi-Cluster Mesh](https://www.meetup.com/San-Diego-Cloud-Native-Computing-Meetup/events/262826967/)\n\n[//]: # (support)\n\n## Collaboration and Communication\n\n[Admiral Slack Channel](https://istio.slack.com/archives/CT3F18T08) \n\n`Note:` This channel is under Istio slack org, please fill out this [form](https://docs.google.com/forms/d/e/1FAIpQLSfdsupDfOWBtNVvVvXED6ULxtR4UIsYGCH_cQcRr0VcG1ZqQQ/viewform) to get access to Istio slack.\n\n## Local Development\nRefer to [Local Development Setup](./CONTRIBUTING.md#setting-up-for-local-development)\n\n## Contributing\nRefer to [Contributing doc](./CONTRIBUTING.md)\n\n## Release Cadence\n\nDetails can be found [here](./docs/Processes.md)\n\n## Admiral Sequence Diagram\n\n### Legend:\nSE - [Istio ServiceEntry](https://istio.io/latest/docs/reference/config/networking/service-entry/)\n\nVS - [Istio VirtualService](https://istio.io/latest/docs/reference/config/networking/virtual-service/)\n\nDR - [Istio DestinationRule](https://istio.io/latest/docs/reference/config/networking/destination-rule/)\n\nK8s API - [Kubernetes API Server](https://kubernetes.io/docs/concepts/overview/kubernetes-api/)\n\nGTP - [Admiral GlobalTrafficPolicy](https://github.com/istio-ecosystem/admiral/blob/master/docs/Architecture.md#global-traffic-policy)\n\n```mermaid\nsequenceDiagram\n\t\tautonumber 1\n    Service/VirtualService Handler-\u003e\u003e+Rollout/Deployment Handler: Add/Update/Delete events\n\t\tautonumber 1\n    GTP/OutlierDetection Handler-\u003e\u003eUpdate All Resources: Add/Update\n    autonumber 1\n    DependencyRecord Handler-\u003e\u003eUpdate All Resources: Add/Update\n\t\tautonumber 1\n\t\tRollout/Deployment Handler-\u003e\u003eUpdate All Resources: Add/Update\n\n    autonumber 2\n    Update All Resources-\u003e\u003eRemoteControllers: Fetch All Cluster Controllers\n\t\trect rgb(255, 255, 220)\n\t    loop\n\t\t    Update All Resources-\u003e\u003eK8sAPI 1..N: For each cluster, get corresponding service object\n\t\t\t\tK8sAPI 1..N--\u003e\u003eUpdate All Resources: Continue if service does not exist for deployment/rollout\n\t\t\t\tK8sAPI 1..N--\u003e\u003eUpdate All Resources: Build list of source services\n\t    end\n\t\tend\n\t  rect rgb(255, 255, 220)\n\t    loop\n\t\t\t\tUpdate All Resources-\u003e\u003eK8sAPI 1..N: Derive SE from each service in the list\n\t\t\t\tUpdate All Resources-\u003e\u003eGTP/OutlierDetection Cache: Derive DR from GTP/OutlierDetection\n\t\t\t  rect rgb(204, 255, 204)\n\t\t\t    loop\n\t\t\t\t    Update All Resources-\u003e\u003eK8sAPI 1..N: Add/Update SE/DR/VS in source clusters\n\t\t\t\t    Update All Resources-\u003e\u003eDynamoDB: Add/Update WorkloadData for source clusters\n\t\t\t\t\tend\n\t\t    end\n\t    end\n\t\tend\n\n    Update All Resources-\u003e\u003eDependencyCache: Fetch dependent clusters\n\t\trect rgb(204, 255, 204)\n\t    loop\n\t\t\t\tUpdate All Resources-\u003e\u003eK8sAPI 1..N: Add/Update SE/DR/VS in dependent clusters\n        Update All Resources-\u003e\u003eDynamoDB: Add/Update WorkloadData for dependent clusters\n\t\t\tend\n\t\tend\n```\n\n# Core contributors\n- [Anil Attuluri](https://github.com/aattuluri)\n- [Anubhav Aeron](https://github.com/nirvanagit)\n- [Shriram Sharma](https://github.com/shriramsharma)\n- [Kartikeya Pharasi](https://github.com/kpharasi)\n- [Vinay Gonuguntla](https://github.com/vinay-g)\n- [Vrushali Joshi](https://github.com/vrushalijoshi)\n- [Viraj Kulkarni](https://github.com/virajrk)\n- [Ryan Tay](https://github.com/rtay1188)\n- [Punakshi Chaand](https://github.com/Punakshi)\n- [Pankaj Sikka](https://github.com/psikka1)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fistio-ecosystem%2Fadmiral","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fistio-ecosystem%2Fadmiral","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fistio-ecosystem%2Fadmiral/lists"}