Helm Charts auf ArtifactHub über Hosting auf Github-Seiten

Lassen Sie uns besprechen, wie wir unsere Helm-Charts auf GitHub-Seiten hosten und anderen Leuten ermöglichen können, unsere Charts auf ArtifactHub zu verwenden. Bevor wir den Prozess verstehen, werden wir versuchen, diese Begriffe in der einfachsten Form zu verstehen

Was ist ein Helm Chart

Mit Helm Charts erstellen Sie Vorlagen für Ihre Kubernetes-Ressourcen, die Sie bereitstellen möchten. Wenn Sie Kubernetes-Ressourcen in mehreren Clustern (oder sogar im selben Cluster) mit unterschiedlichen Werten erstellen möchten, erstellen Sie eine Vorlage für die Ressourcen und verpacken sie. Dieses Paket ist als Helm Chart bekannt.

GitHub-Seiten

GitHub Pages ist eine Funktion von GitHub, mit der Sie eine Website oder eine Webseite erstellen können, die auf GitHub-Servern gehostet wird. Wenn Sie eine einfache haben index.html Datei, dann können Sie diese HTML-Datei mit dem von GitHub bereitgestellten Domainnamen hosten, der im Allgemeinen das Format hat benutzername.github.io . Auf diese Weise können Sie Ihre Arbeit teilen oder Ihre Projekte online präsentieren, ohne dass Sie einen separaten Webhosting-Dienst benötigen. In unserem Fall werden wir Wirt unsere Helm-Charts auf GitHub-Seiten.

Artefakt-Hub

ArtifactHub ist eine webbasierte Plattform, die als zentrales Repo für verschiedene Softwaredistributionen wie Helm-Charts, OPA usw. fungiert. Sobald wir unser Helm-Diagramm erstellt und auf GitHub-Seiten gehostet haben, werden wir es für die Community auffindbar machen, indem wir es auf Artifacthub präsentieren.

ArtifactHub hostet die Helm-Charts nicht selbst, sondern dient als Registry für Helm-Chart-Repositorys. Entwickler können ihre Helm-Charts in ihrem bevorzugten Repository wie GitHub, GitLab oder Bitbucket veröffentlichen und ihr Repository dann bei ArtifactHub registrieren.

Helm-Charts über GitHub-Seiten hosten

Jetzt werden wir sehen, wie wir die Pages-Funktionen von GitHub nutzen können, um die Helm-Charts unserer Anwendung zu hosten. In diesem Beispiel nehme ich ein Beispiel für Helm-Charts, aber Sie können auch Ihre eigenen benutzerdefinierten Helm-Charts auf die gleiche Weise verwenden

Schritt 1: Erstellen eines Beispiel-Helmdiagramms

Wir beginnen mit der Erstellung eines Beispiel-Helmdiagramms

helm create sample-nginx


Schritt 2: Erstelle ein GitHub-Repo

Wir werden ein öffentliches GitHub-Repo erstellen, in dem wir die Charts hosten werden.

• Erstelle ein GitHub-Repo
• Stellen Sie sicher, dass es öffentlich ist
• Erstellen Sie ein Verzeichnis mit dem Namen Diagramme das wird deine Helmkarte enthalten
• Diagramme Das Verzeichnis befindet sich auf der Stammebene Ihres Repositorys
• Verschiebe deine Charts in das Repositorium Haupt Ast

$ Baum.
.
√── README.md
•── Diagramme
•── Beispiel-Nginx
√── Chart.yaml
√── Diagramme
√── Vorlagen
│ √── NOTES.txt
│ √── _helpers.tpl
│ √── Bereitstellung.yaml
│ √── hpa.yaml
│ √── ingress.yaml
│ √── service.yaml
│ √── serviceaccount.yaml
│ │ ── Tests
│ │ ── test-connection.yaml
•── Werte.yaml



Wir haben ein Repo erstellt und es wird hier gehostet:

‍

GitHub - dunefro/sample-charts

Contribute to dunefro/sample-charts development by creating an account on GitHub.

GitHub dunefro

‍

Schritt 3: Github Access Token erstellen

Sobald unsere Charts in der Haupt Branch Wir müssen eine Pipeline erstellen, die eine GitHub-Version erstellen kann. Diese GitHub-Version wird im Gegenzug unsere Charts veröffentlichen. Dafür benötigen wir eine Zeichen muss mit einem bestimmten Satz von erstellt werden Berechtigungen die dann in unserer Pipeline zur Veröffentlichung von Charts verwendet werden.

• Klicke oben rechts auf dein GitHub-Profil
• Gehe zu Einstellungen.
• Gehe zu Einstellungen für Entwickler in der letzten Option im linken Bereich.
• Gehe zu Token für den persönlichen Zugriff und wähle Feinkörnige Spielsteine.
• Klicken Sie auf Neues Token generieren

• Geben Sie einen Token-Namen ein und wählen Sie das Ablaufdatum aus. Im Moment verwende ich 7 Tage nach Ablauf der Frist, welches Token nutzlos wird.
• Wählen Sie im Repository-Zugriff Nur Repositorys auswählen und wählen Sie unser Github-Repo aus, in dem wir arbeiten

• Im Abschnitt Berechtigungen müssen wir nur Repository-Berechtigungen verwenden.
• In dieser Auswahl benötigen wir Lesen und schreiben zum Inhalt

• Im Überblick müssen wir nur so viele Berechtigungen haben.
• Sobald das Token generiert wurde, bewahren Sie es für den nächsten Schritt sicher bei sich auf.

Schritt 4: GitHub-Seiten einrichten

Wir können GitHub Pages verwenden, um unsere Website direkt auf GitHub zu hosten (statisch).

• Lassen Sie uns einen weiteren Zweig im Repository mit dem Namen erstellen gh-Seiten und achten Sie darauf, den Zweig nach zu benennen gh-Seiten nur.
• In diesem Zweig entfernen Sie alles und erstellen Sie einfach eine einfache Datei index.html um das Hosting zu testen. Übertrage deine Änderungen auf GitHub.

<DOCTYPE html>
<html>
<head>
<title>Beispieldiagramme</title>
<style>
.diagramm {
Breite: 400px;
Höhe: 300px;
Rand: 20 Pixel;
Rand: 1px solid #ccc;
Box-Schatten: 2px 2px 5px #ccc;
Anzeige: Inline-Block;
vertikal ausrichten: oben;
Polsterung: 10px;
Boxgröße: Borderbox;
Schriftgröße: 14px;
Zeilenhöhe: 1,5;
}

.diagramm h3 {
Rand oben: 0;
Schriftgröße: 18px;
Schriftstärke: fett;
}

.diagramm p {
Spielraum: 0;
}
</style>
</head>
<body>
<h1>Beispieldiagramme</h1>
<div class="chart">
<h3>Grafik 1</h3>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Ganzzahl euismod diam et purus hendrerit mollis</p>.
<!-- add your chart code here -->
</div>
<div class="chart">
<h3>Schaubild 2</h3>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Ganzzahl euismod diam et purus hendrerit mollis</p>.
<!-- add your chart code here -->
</div>
<div class="chart">
<h3>Schaubild 3</h3>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Ganzzahl euismod diam et purus hendrerit mollis</p>.
<!-- add your chart code here -->
</div>
</body>
</html>


• Gehe unter dem Namen deines Repositorys zu Einstellungen und klicke im linken Bereich auf Seiten.

• Wählen Sie im Abschnitt Build and Deployment den Branch aus. gh-Seiten und warte einige Zeit, bis GitHub es verarbeitet hat. Sobald dies erledigt ist, erhalten Sie eine URL im selben Fenster. Wenn Sie darauf klicken, wird Ihnen das angezeigt index.html wir haben geschaffen.
• Klicken Sie hier, um unsere index.html zu überprüfen — https://dunefro.github.io/sample-charts/
• Anstatt diese HTML-Datei zu hosten, hosten wir jetzt unsere Helm-Charts.

Schritt 5: Pipeline in GitHub Actions erstellen

In den vorherigen Schritten haben wir über die Pipeline gesprochen, die das Access-Token verwendet, um ein GitHub-Release zu erstellen. Sie können jedes bevorzugte Tool für die Ausführung dieser Aufgabe wählen, aber ich werde dafür GitHub Actions wählen. GitHub Actions ist ein weiteres Tool, das von GitHub nativ unterstützt wird, um CI/CD-Aufgaben auszuführen.

Bevor wir die Pipeline erstellen, erstellen wir eine geheime Variable, um das Token zu übergeben, das wir in der vorherigen Aufgabe erstellt haben.

• Gehe zu deinem Repository und klicke unter dem Namen deines Repos auf Einstellungen

• Gehen Sie im linken Bereich zu Secrets and Variables und klicken Sie auf Aktionen
• Klicken Sie auf New Repository Secret und fügen Sie das Token ein

Dieses Token kann jetzt in der Pipeline verwendet werden, um die Releases zu pushen.

Jetzt erstellen wir die GitHub Action-Pipeline

• Erstellen Sie ein Verzeichnis .github/arbeitsabläufe in der Stammebene deines Repositorys im Haupt Zweig.
• Dieses Verzeichnis ist das Standardverzeichnis, in dem wir alle CI/CD-Pipelines für die Ausführung von GitHub-Aktionen speichern.
• Erstellen Sie eine Datei mit dem Namen .yaml veröffentlichen im obigen Verzeichnis.
• Fügen Sie den folgenden Inhalt ein

Name: Release-Charts

auf:
drücken:
Filialen:
- Haupt

Jobs:
Veröffentlichung:
Berechtigungen:
Inhalt: schreibe #, um das Chart-Release zu pushen und ein Release zu erstellen (helm/chart-releaser-action)

läuft auf: Ubuntu-latest
Schritte:
- Name: Checkout-Code
verwendet: actions/checkout @v3
mit:
Abruftiefe: 0

- Name: Git konfigurieren
ausführen: |
git config user.name „$GITHUB_ACTOR“
git config user.email „$ GITHUB_ACTOR@users.noreply.github.com“
- Name: Helm einrichten
verwendet: azure/setup-helm @v3 .5
mit:
Ausführung: v3.9.2

- Name: Chart-Releaser ausführen
verwendet: helm/chart-releaser-action @v1 .5.0
Umgebung:
CR_TOKEN: „$ {{secrets.HELM_RELEASE_TOKEN}}“


Diese Pipeline ist sehr einfach. Lass es uns sehr schnell verstehen

1. Name — Name der Pipeline
2. auf — Bedingung zum Ausführen der Pipeline, hier geben wir an, dass sie bei jedem Push ausgeführt werden soll Haupt Zweig.
3. Jobs — der eigentliche Job, der den Pipeline-Code enthält. Es prüft die Berechtigungen von schreiben in Inhalten, die wir bereits gegeben haben
4. Schritte definieren Sie die Pipeline-Schritte. In dem der erste Schritt zu verwenden ist Aktionen/Checkout @v3 . Wenn Sie die Pipeline erstellen, würden Sie idealerweise zuerst den Code auschecken. Anstatt den Code zum Auschecken zu schreiben, bietet GitHub eine Aktion was direkt verwendet werden kann, anstatt den Code zu schreiben.
5. Im zweiten Schritt führen wir die Befehle aus, um Git zu konfigurieren. Ähnlich verwenden wir im dritten Schritt azurblau/setup-helm Aktion, die das Ruder für uns in die Hand nehmen wird.
6. Im letzten Schritt verwenden wir Helm/Chart-Releaser-Aktion um die Helmkarte zu veröffentlichen. Für die Veröffentlichung benötigen wir das geheime Token, das wir bereits erstellt und in der Pipeline über den Token-Namen weitergegeben haben HELM_RELEASE_TOKEN . Diese Aktion wird auch eine erstellen index.yaml in gh-Seiten Branch, durch den die GitHub-Seite als statische Registrierung für die Helm-Charts fungiert.

Schritt 6: Führen Sie die Pipeline aus und überprüfen Sie, ob die Releases erstellt wurden oder nicht

Jetzt werden wir sehr kleine Änderungen an der vornehmen LIES ME.md Datei des Repositorys im Haupt verzweigen, sodass die Pipeline ausgelöst wird. Wenn ich die Änderungen vorgenommen habe, sehe ich einen kleinen orangefarbenen Punkt, der bedeutet, dass eine Pipeline läuft

• Gehen Sie unter dem Repository-Namen zu Aktionen und suchen Sie nach den laufenden Pipelines.
• Sobald die Pipeline fertig ist, können wir gehen zu gh-Seiten verzweige und prüfe ob index.yaml ist geschaffen oder nicht.
• index.yaml ist eine Methode, mit der Helm jede statisch gehostete Website als Helm-Registrierung identifizieren kann.
• Sobald die Pipeline fertig ist, wird automatisch eine weitere Pipeline mit dem Namen von ausgelöst Erstellung und Bereitstellung von Seiten das automatisch von GitHub erstellt wird, um die Änderungen zu hosten, die wir in der Filiale gh-pages Herstellung index.yaml öffentlich verfügbar. — https://dunefro.github.io/sample-charts/index.yaml
• Wir können die Veröffentlichungen auf GitHub überprüfen, um festzustellen, dass unser Helm-Diagramm auf der Releases-Seite veröffentlicht wurde. — https://github.com/dunefro/sample-charts/releases

Schritt 7: Bestätigen Sie die Version, indem Sie sie in einem Minikube-Cluster bereitstellen

Um zu testen, ob unsere Helm-Registrierung erfolgreich erstellt wurde oder nicht

• Erstellen Sie eine Minikube Cluster
• Führen Sie den folgenden Befehl aus

# füge das Repo hinzu
Helm-Repo füge Beispieldiagramme hinzu https://dunefro.github.io/sample-charts/
Helm-Repo-Aktualisierung

# installiere die Charts
helm upgrade --install test-nginx sample-charts/sample-nginx

# Pods überprüfen
$ kubectl get pods
NAME: BEREIT, STATUS, NEUSTARTS, ALTER
test-nginx-sample-nginx-b95bb4f46-tbppn 1/1 Läuft 0 30s


Unsere Charts funktionieren einwandfrei.

ArtifactHub einrichten

Jetzt werden wir versuchen zu sehen, wie wir ein Konto auf ArtifactHub einrichten können, damit wir unsere Helm-Charts der Community zeigen können. Vielleicht findest du auch einige andere Community-Charts wie

• Argocd-Helmdiagramm
• Datadog Helmdiagramm
• Grafana-Helmkarte
• Prometheus-Helmkarte

Schritt 1: Konto auf ArtifactHub erstellen und Repo erstellen

Jetzt sind unsere Charts gehostet. Wir müssen sicherstellen, dass sie von anderen Entwicklern über ArtifactHub verwendet werden können.

• Gehe zu https://artifcathub.io und melde dich an.
• Veröffentlichen Sie dies, klicken Sie in der oberen linken Ecke auf Ihr Profilsymbol und dann auf Control Panel.
• Klicken Sie auf + Repository hinzufügen und fügen Sie die Repository-Details hinzu. Stellen Sie sicher, dass Sie die URL verwenden, unter der Ihre Diagramme auf GitHub-Seiten gehostet werden.

• Jetzt warte und entspann dich. ArtifactHub ruft die Details automatisch mit dem ab index.yaml auf unseren Seiten gehostet

Schritt 2: Verifiziere dein Repo

Wir können sehen, wie unser Repo erstellt wird, und sobald ArtifactHub die Daten abrufen kann, werden sie sich auch in den Suchanfragen widerspiegeln. Jetzt wollen wir das verifizierte Publisher-Tag in etwa so anwenden

Dafür müssen wir eine Datei hinzufügen artifacthub-repo.yml in der gh-Seiten Branch als Metadatendatei, die von ArtifactHub gelesen wird, um zu überprüfen, ob wir der Eigentümer der Registrierung sind.

• Kopieren Sie die ID aus dem Repository, das wir erstellt haben.
• Erstellen Sie eine Datei mit dem Namen artifacthub-repo.yml in der gh-Seiten Zweig mit folgenden Inhalten

Repository-ID: 67d52f16-b102-4661-bfa5-9e6694587e24
Besitzer: # (optional, wird verwendet, um die Inhaberschaft des Repositorys zu beanspruchen)
- Name: Vedant Pareek
E-Mail: dunefro@gmail.com


• Aktualisieren Sie das Ausführung von deinem Diagramm, damit ArtifactHub und GitHub Actions es aufnehmen können.
• Warten Sie einige Zeit, bis ArtifactHub die Überprüfung der Registrierung durchgeführt hat.

Auf die gleiche Weise haben wir früher unsere öffentlichen Helm-Charts unter gehostet Echte Gießerei. TrueFoundry ist MLOPs, LLMOPs Eine Plattform, die den gesamten Lebenszyklus der Einführung der Modelle für maschinelles Lernen von der Entwicklung bis zur Produktion erleichtert. Sie berücksichtigt alle Problembereiche während des gesamten Lebenszyklus des maschinellen Lernens, um die Erstellung von Modellen zu vereinfachen und zu vereinfachen.