Envoy ist ein erweiterbarer Proxy für moderne Netzwerke

Ein von der CNCF gehosteter Proxy für Edge, Middle und Service

Die README beginnt mit der Ein-Satz-Beschreibung des Projekts: "Cloud-native high-performance edge/middle/service proxy." Dann heißt es, dass Envoy von der Cloud Native Computing Foundation (CNCF) gehostet wird, mit einem Link zur CNCF-Ankündigung vom September 2017 über das Hosten von Envoy. Die Repository-Metadaten nennen C++ als Hauptsprache und envoyproxy.io als Homepage. Die README definiert selbst nicht, was "edge/middle/service" operativ bedeutet, und nennt weder Leistungszahlen noch eine Liste von Anwendern; diese Details liegen außerhalb des Rahmens der README und müssten anderswo bestätigt werden.

Dokumentation, Beispiele und verwandte Repositories

Unter "Documentation" verweist die README auf die offizielle Dokumentation unter envoyproxy.io, ein FAQ, eine Beispiel-Dokumentation im separaten Repository envoyproxy/examples und fünf Blogbeiträge. Die Blogbeiträge behandeln Envoys Threading-Modell, Hot Restart, Statistikarchitektur, die universelle Data-Plane-API und Lyfts Envoy-Dashboards. Der Abschnitt "Related" listet drei Repositories auf: data-plane-api (ein schreibgeschützter Spiegel des api-Verzeichnisses für v2-API-Definitionen), envoy-perf (ein Framework für Leistungstests) und envoy-filter-example (ein Beispiel zum Hinzufügen neuer Filter und zur Verknüpfung mit dem Hauptrepository). Die README selbst enthält keine Versionsnummern oder API-Details.

Mailinglisten, Slack und ein zweimal monatliches Treffen

Der Kontaktbereich listet vier Google Groups auf: envoy-announce für seltene Ankündigungen, envoy-security-announce nur für Sicherheitsankündigungen, envoy-users für allgemeine Benutzerdiskussionen und envoy-dev für Entwicklerdiskussionen. Es gibt auch eine envoy-maintainers-Liste, um die Kern-Maintainer zu erreichen. Die README sagt, dass Slack verfügbar ist, aber Antworten auf Benutzerfragen in Slack nur nach bestem Bemühen erfolgen, während eine "garantierte" Antwort eine E-Mail an envoy-users erfordert. Ein Community-Meeting ist zweimal im Monat dienstags um 9 Uhr PT angesetzt, findet aber nur statt, wenn es Tagesordnungspunkte im öffentlichen Protokoll gibt. Die README sagt nicht, wann das nächste Meeting stattfindet oder wer normalerweise teilnimmt. Sie verlinkt auch den EnvoyProxy-Twitter-Account.

Beiträge: Docker-basierte Builds und Anfänger-Issues

Der Beitragsabschnitt sagt, dass Beitragen "Spaß macht" und dass modernes C++ "viel weniger beängstigend" ist, als man ohne Erfahrung denken könnte. Er verlinkt einen Leitfaden für Beiträge, eine Liste von Anfänger-Issues, einen Schnellstart für Build/Test mit Docker (der Link führt zum ci-Verzeichnis), einen Entwicklerleitfaden und eine Entwicklungshilfs-Toolchain. Außerdem wird gebeten, Maintainern mitzuteilen, wenn man an einem Issue arbeitet, um Doppelarbeit zu vermeiden. Die README enthält nicht die eigentlichen Docker-Befehle oder eine Schritt-für-Schritt-Bauanleitung; diese stehen in den verlinkten ci- und Entwicklerleitfaden-Dateien. Die Repository-Metadaten zeigen derzeit 28.716 Sterne und 5.536 Forks, aber die README selbst erwähnt keine Statistiken.

Sicherheitsaudits, Schwachstellenmeldung und eine Ausnahme für ppc64le

Der Sicherheitsabschnitt verzeichnet zwei Engagements von Dritten: ein Sicherheitsaudit von Cure53 aus dem Jahr 2018 mit vollständigem Bericht unter docs/security/audit_cure53_2018.pdf und ein Audit von Ada Logics aus dem Jahr 2021 über die Fuzzing-Infrastruktur mit Empfehlungen, ebenfalls mit vollständigem Bericht. Zur Meldung einer Schwachstelle weist die README darauf hin, ein GitHub Security Advisory zu öffnen oder alternativ eine E-Mail an envoy-security@googlegroups.com zu senden, und verweist auf den vollständigen Sicherheitsrelease-Prozess in SECURITY.md. Die README stellt außerdem fest, dass Builds für die ppc64le-Architektur nicht von der Sicherheitsrichtlinie abgedeckt, nur nach bestem Bemühen gepflegt und nicht von Envoy-Maintainern gewartet werden. Sie sagt nicht, ob die Audits aktuell sind oder ob alle gefundenen Probleme behoben wurden; das erfordert das Lesen der Berichte. Nach dem Sicherheitsabschnitt gibt es noch die Überschriften "OSS fuzzing" und "Other builds", aber keinen Text.

Lizenz, Repository-Metadaten und was die README offen lässt

Das Repository ist unter Apache-2.0 lizenziert, wie Lizenzdatei und Metadaten zeigen. Die Apache License 2.0 gewährt eine unbefristete, weltweite, nicht exklusive, gebührenfreie, lizenzgebührenfreie Urheberrechtslizenz, um das Werk zu vervielfältigen, abgeleitete Werke zu erstellen, öffentlich auszustellen und aufzuführen, zu unterlizenzieren und zu verbreiten, einschließlich einer bedingten Patentlizenz. Der Lizenztext macht keine Zusagen zu Sicherheit, Support oder Garantie; diese sind nicht abgedeckt. Die README enthält keine Installationsanweisungen, keine Funktionsliste und keine Leistungsbenchmarks. Das Repository ist nicht archiviert, verwendet main als Standardbranch und hat laut Metadaten 1.825 offene Issues. Für Installations-, Konfigurations- oder Betriebsdetails sind die offizielle Dokumentation und das Beispiel-Repository die nächsten Anlaufstellen. Für Envoy sind insbesondere Envoy, bazel, bazel build, bazel test, envoyproxy/envoy, docs relevant. Diese Bezeichnungen stammen aus der README und markieren die Punkte, die bei einer Prüfung dieses konkreten Projekts zusammengehören. Ein sinnvoller erster Test nutzt bei Envoy den dokumentierten Einstieg bazel und beobachtet das dort beschriebene Ergebnis. Erst danach lässt sich beurteilen, ob Envoy zur eigenen Umgebung passt. Die README belegt Funktionen und Grenzen, aber keine allgemeine Zusage für jede Installation.

Redaktionelles Fazit

Geeignet für Teams, die Envoy genau in dem von der README beschriebenen Rahmen einsetzen. Ungeeignet als Ersatz für fehlende Betriebsannahmen. Prüfe zuerst bazel, bazel build und die dazugehörige Ausgabe beziehungsweise Konfiguration, bevor du eine verbindliche Auswahl triffst.

Offizielle Quellen

1. Official documentation
2. Official README
3. Project repository
4. Release notes