Ce que vous devez retenir
- Avant de forker ArgoCD pour un manque d’UI, vérifiez ses hooks de configuration : cinq lignes de Deep Links suffisent ici.
- Pour HTTPRoute, l’URL et la condition n’utilisent pas le même moteur de templating ; c’est le détail qui évite beaucoup d’essais inutiles.
- Le premier hostname couvre généralement le besoin sans complexifier la configuration pour gérer tous les cas possibles.
- Une extension déclarative, versionnée en GitOps, coûte beaucoup moins cher à maintenir qu’un fork pour une différence d’interface mineure.
Dans l’UI ArgoCD, quand on clique sur un node Ingress dans le graph d’une app, une petite flèche “↗” apparaît et ouvre directement l’URL publique dans un nouvel onglet. Pratique pour tester vite fait qu’un service répond.
Pour les HTTPRoute de la Gateway API, cette flèche n’existe pas. Pourtant l’info est là : spec.hostnames[] contient exactement ce qu’il faut. Juste que l’UI upstream n’a pas été mise à jour pour le gérer.
L’option naïve : forker l’UI
Première idée qui vient : forker argo-cd, patcher ui/src/app/applications/components/utils.tsx pour ajouter la logique d’extraction d’URL depuis les HTTPRoute, rebuild l’image server, déployer. Ça marche, mais on hérite d’un fork à maintenir pour cinq lignes de code, et on recompile à chaque bump d’ArgoCD.
Pas terrible pour un simple lien.
Deep Links : la feature pile poil pour ça
ArgoCD a une feature native appelée Deep Links, sous-utilisée parce que sa doc est planquée. Elle permet de définir des liens dynamiques qui apparaissent dans le panneau de détails des resources - exactement au même endroit que la flèche Ingress native.
La config se fait dans le ConfigMap argocd-cm, avec trois niveaux possibles :
project.links- au niveau projetapplication.links- au niveau appresource.links- au niveau d’une resource K8s individuelle
C’est le troisième qui nous intéresse. Pour chaque entrée, on fournit :
- Une URL templatée (syntaxe Go
text/template) - Une condition
if(syntaxeexpr-lang/expr) qui décide quand le lien s’affiche - Un titre et une icône FontAwesome
Le patch
Cinq lignes à ajouter dans argocd-cm :
resource.links: |
- url: https://{{ index .resource.spec.hostnames 0 }}
title: Open endpoint ↗
if: resource.kind == "HTTPRoute" && resource.spec.hostnames != nil && len(resource.spec.hostnames) > 0
icon.class: "fa-external-link-alt"
Si ArgoCD est déployé via le chart officiel (c’est mon cas), ça va dans les values :
configs:
cm:
resource.links: |
- url: https://{{ index .resource.spec.hostnames 0 }}
title: Open endpoint ↗
if: resource.kind == "HTTPRoute" && resource.spec.hostnames != nil && len(resource.spec.hostnames) > 0
icon.class: "fa-external-link-alt"
Commit, push, ArgoCD sync son propre ConfigMap. En théorie argocd-cm est rechargé à chaud via l’informer côté server, mais dans la pratique le cache des settings ne se rafraîchit pas toujours instantanément. Un petit coup de :
kubectl rollout restart deployment argocd-server -n kube-infra
… et l’onglet Links apparaît sur les nodes HTTPRoute, avec la flèche “↗” sur le node :

Ce qu’il se passe côté templating
Deux moteurs différents cohabitent dans une même entrée, et c’est un peu déroutant au début :
URL - Go text/template. On accède aux champs avec .resource, .app, .cluster, .project. Pour les slices, il faut index parce que la notation [0] n’existe pas en Go template :
{{ index .resource.spec.hostnames 0 }}
Condition if - expr-lang/expr, plus proche d’une expression booléenne classique. Là on accède sans point initial (resource.kind et pas .resource.kind), on peut utiliser len(), nil, les opérateurs logiques &&, || :
resource.kind == "HTTPRoute" && resource.spec.hostnames != nil && len(resource.spec.hostnames) > 0
Le double check != nil && len() > 0 évite un template rendering error si un HTTPRoute mal formé passe par là.
Le scheme https:// est hardcodé dans mon cas parce que mon Gateway traefik-gateway-global fait du TLS partout. Si on a des routes HTTP, il faut conditionner le scheme - plus compliqué, on y revient plus bas.
Étendre à d’autres CRDs Gateway API
La même logique s’applique à tout ce qui porte une URL publique. Par exemple pour Gateway avec listeners[].hostname :
resource.links: |
- url: https://{{ index .resource.spec.hostnames 0 }}
title: Open endpoint ↗
if: resource.kind == "HTTPRoute" && resource.spec.hostnames != nil && len(resource.spec.hostnames) > 0
icon.class: "fa-external-link-alt"
- url: https://{{ (index .resource.spec.listeners 0).hostname }}
title: Gateway endpoint ↗
if: resource.kind == "Gateway" && len(resource.spec.listeners) > 0 && resource.spec.listeners[0].hostname != nil
icon.class: "fa-door-open"
Multi-hostnames
Un HTTPRoute peut déclarer plusieurs hostnames. Malheureusement, une entrée Deep Link = un lien, donc pas de boucle range possible pour générer N liens dynamiquement. Deux options :
Option 1 - premier hostname seulement (ce que fait l’exemple au-dessus). Couvre 99% des cas, simple.
Option 2 - une entrée par index :
resource.links: |
- url: https://{{ index .resource.spec.hostnames 0 }}
title: Endpoint ↗
if: resource.kind == "HTTPRoute" && len(resource.spec.hostnames) > 0
- url: https://{{ index .resource.spec.hostnames 1 }}
title: Endpoint (alt 1) ↗
if: resource.kind == "HTTPRoute" && len(resource.spec.hostnames) > 1
- url: https://{{ index .resource.spec.hostnames 2 }}
title: Endpoint (alt 2) ↗
if: resource.kind == "HTTPRoute" && len(resource.spec.hostnames) > 2
Moche mais fonctionnel. En pratique je m’en tiens au premier.
Pourquoi c’est mieux qu’un fork
Pour cinq lignes de config :
- Pas de fork à maintenir, pas de sync upstream à gérer
- Pas de rebuild d’image quand ArgoCD passe de v3.3 à v3.4
- GitOps-friendly - la config est versionnée comme le reste
- Minimal downtime - un simple rollout restart du server (~10s)
- Extensible gratos - ajouter des liens pour Grafana, Datadog, etc. sur d’autres resources, c’est le même mécanisme
La seule chose que Deep Links ne permet pas, c’est de modifier l’emplacement exact du lien - la flèche native d’Ingress est dans le header du panneau, alors que Deep Links crée un onglet “Links”. UX légèrement différente mais parfaitement utilisable.
Upstream ?
La “vraie” solution serait de soumettre une PR à argoproj/argo-cd pour ajouter le support natif des HTTPRoute dans le code qui extrait les URLs d’Ingress. Mais ça prend des mois à merger, et en attendant Deep Links résout le problème aujourd’hui, pour tout le monde, sans rien casser.
C’est souvent le cas avec ArgoCD : avant de forker ou de râler sur un truc manquant, vérifier s’il n’y a pas déjà un hook de config qui fait le job. Sa surface d’extensibilité est bien plus large qu’elle n’en a l’air.