Site Web avec des pages statiques (générateur de pages ou simplement HTML/CSS)
Générateur de pages statiques avec Pelican
- Pour démarrer, clonez ce dépôt d'exemple et basez-vous dessus pour la suite.
Déploiement de votre site Web statique
- Connectez-vous sur PLMshift
- Créez un projet en allant sur Add, fournissez un nom unique
-
Créez une application Site Web depuis le catalogue en choisissant From Catalog->Python
-
Renseignez l'URL de votre dépôt GIT (en vous basant par exemple sur
https://plmlab.math.cnrs.fr/plmshift/pelican.git
) - si votre dépôt est public, l'URL sera de la forme :
https://plmlab.math.cnrs.fr/votre_groupe/mes_pages.git
- si vous souhaitez un dépôt privé, l'URL sera de la forme :
git@plmlab.math.cnrs.fr:votre_groupe/mes_pages.git
[^1] - Avant de cliquer sur Create, cliquez sur Routing et forcez HTTPS en cliquant sur Secure Route
- Cliquez sur Create en bas de page
- Patientez et ensuite connectez-vous sur l'URL de votre déploiement
Déploiement en ligne de commandes
oc new-project <mon_site_web>
oc new-app python~https://plmlab.math.cnrs.fr/mon_groupe/mes_pages.git --name <mon-site>
oc create route edge --service=<mon-site> --hostname=<mon-site-python>.apps.math.cnrs.fr
oc get routes
Générateur de pages statiques avec Hugo
- Pour démarrer, créez un dépôt GIT contenant un site basé sur Hugo : créez un projet sur PLMlab, en choisissant Create from template et le template Pages/Hugo
Déploiement de votre site Web statique
- Connectez-vous sur PLMshift en ligne de commande
- Déployez votre site (dans votre cas, changez
<mon-site>
par le nom de votre choix) :
# Ne pas oublier l'extension .git à l'URL de votre dépôt
oc new-app plmshift/hugo-base~https://plmlab.math.cnrs.fr/moi/mon_site.git --name=<mon-site>
oc create route edge --service=<mon-site> --hostname=<mon-site>.apps.math.cnrs.fr
oc get routes
Pour utiliser les lignes de commandes indispensables à cela, c'est ici.
Patientez un peu et consultez l'URL de votre service (visible via la commande oc get route
)
Si votre dépôt est privée vous allez devoir obtenir un deploy_token dans PLMLab (GitLab), puis créer un secret et l'associer au build dans PLMshift. Vous trouverez la marche à suivre ici. Et pour utiliser les lignes de commandes indispensables à cela, c'est ici.
Remarque : Pour modifier l'option baseurl=
du fichier config.toml
de votre dépôt GIT afin que cela corresponde à l'URL de votre déploiement (ou adapter votre config.toml
), vous devez :
- créer un Deployment Config en allant dans Projet(1) et Deployment Config (2), puis Create Deployment Config (en haut à droite) et Create (en bas à gauche).
- Dans un terminale rentrez :
oc set env dc/<mon-site> HUGO_OPTIONS="-b https://mon_site_hugo.apps.math.cnrs.fr"
Patientez (cela peut prendre un certain temps) et ensuite connectez-vous sur l'URL de votre déploiement. Pour la trouver: clickez sur le Deployment Config (cercle bleu) de votre site et dans le panneau qui s'ouvre à droite, dans Routes vous avez la Location. URL : l'URL par défaut sera de la forme nom_appli-nom_projet.apps.math.cnrs.fr. Il est possible de la changer en remplissant le paramètre PUBLIC_URL avec un nom d'hôte valable (ex : mon_gds.apps.math.cnrs.fr). [^1]
Directement avec des fichiers HTML et CSS
- Créez un dépôt GIT avec vos fichiers HTML et CSS
Déploiement de votre site Web statique
- Connectez-vous sur PLMshift
- Créez un nouveau projet en allant sur la flèche après projet (1) et clickez sur create project (2) , fournissez un nom unique
- Créez une application Site Web depuis le catalogue en choisissant From Catalog->Apache HTTP Server (httpd)
-
Renseignez l'URL de votre dépôt GIT
-
l'URL de votre dépôt sera de la forme :
https://plmlab.math.cnrs.fr/votre_groupe/mes_pages.git
- si votre dépôt est privé, vous devez au préalable créer un Source secret et l'associer à votre dépôt (pour en savoir plus). Pour cela: clickez sur Show Advance Git Options puis Source Secret Name, Create New Secret.
Donnez un nom à votre secret, laissez Basic Authentication, renseignez le Username et le Token que vous avez créé sur votre dépôt.
- Avant de cliquer sur Create, cliquez sur Routing et forcez HTTPS en cliquant sur Secure Route et sélectionner edge pour l'option
TLS Termination
-
Cliquez sur Create en bas de page
-
Patientez (cela peut prendre un certain temps) et ensuite connectez-vous sur l'URL de votre déploiement. Pour la trouver: clickez sur le Deployment Config (cercle bleu) de votre site et dans le panneau qui s'ouvre à droite, dans Routes vous avez la Location. URL : l'URL par défaut sera de la forme nom_appli-nom_projet.apps.math.cnrs.fr. Il est possible de la changer en remplissant le paramètre PUBLIC_URL avec un nom d'hôte valable (ex : mon_gds.apps.math.cnrs.fr). [^1]
Déploiement en ligne de commandes
oc new-project <mon_site_web>
oc new-app centos/httpd:2.4-el7~https://plmlab.math.cnrs.fr/mon_groupe/mes_pages.git --name <mon-site>
oc create route edge --service=<mon-site> --hostname=<mon-site>.apps.math.cnrs.fr
oc get routes
Si vous avez un dépot privé, ajoutez l'option --source-secret=nom_de_mon_secret
à la commande oc new-app
ci dessus, pour y associer le Source secret (pour en savoir plus)
Cycle de vie de votre application
-
Editez les fichiers dans votre dépôt GIT