Docs

Adresse et domaines

Chaque application répond en HTTPS sur une adresse arkya.app. Ajoute ton propre domaine avec un enregistrement DNS ; le certificat suit tout seul.

L’adresse arkya.app

Dès sa première mise en service, ton application répond sur une adresse de la forme mon-api-a1b2c3d.arkya.app, en HTTPS. ark deploy, ark info et l’onglet Domaines l’affichent.

Une application est toujours publique sur le web. Pour qu’un service reste privé, comme une base, garde-le dans le projet : voir Les projets.

Ajouter ton domaine

  1. Ouvre l’onglet Domaines de l’application.
  2. Ajoute ton domaine, par exemple app.mondomaine.fr.
  3. Chez ton registrar, pose l’enregistrement que l’onglet affiche : un CNAME vers l’adresse arkya.app de l’application.
Sortie
app.mondomaine.fr.   CNAME   mon-api-a1b2c3d.arkya.app.

Le certificat TLS est émis automatiquement dès que le DNS pointe sur Arkya. Compte quelques minutes, le temps que le DNS se propage.

Un domaine nu

Un domaine sans sous-domaine, comme mondomaine.fr, n’accepte pas de CNAME. Pose à la place un enregistrement A vers l’adresse IP de l’application, ou un ALIAS si ton fournisseur DNS le propose.

Terminal
dig +short mon-api-a1b2c3d.arkya.app

Les règles

  • Un domaine ne sert qu’une application à la fois.
  • Les noms en arkya.app sont réservés aux adresses d’Arkya.
  • Chez Cloudflare, laisse le domaine en « DNS seul », nuage gris : Arkya émet et sert lui-même le certificat.

Quand le certificat n’arrive pas

Vérifie d’abord que ton domaine pointe bien sur Arkya :

Terminal
dig +short app.mondomaine.fr

Si le DNS est bon mais que le navigateur signale toujours un certificat invalide, retire le domaine dans l’onglet Domaines, puis ajoute-le de nouveau : l’émission repart.

Depuis l’API

GET, POST et DELETE sur /api/apps/mon-api/domains lisent, ajoutent et retirent les domaines. Le CLI n’a pas encore de commande pour cela. Voir L’API HTTP.