-
-
Notifications
You must be signed in to change notification settings - Fork 1.5k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
i18n(fr): add
guides/deploy/clever-cloud.mdx
(#9508)
See #9030 Co-authored-by: Paul Valladares <85648028+dreyfus92@users.noreply.github.com>
- Loading branch information
1 parent
657f42d
commit e9c3074
Showing
1 changed file
with
126 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,126 @@ | ||
--- | ||
title: Déployez votre site Astro sur Clever Cloud | ||
description: Comment déployer votre site Astro sur le web avec Clever Cloud. | ||
type: deploy | ||
i18nReady: true | ||
--- | ||
import { Tabs, TabItem, Steps } from '@astrojs/starlight/components'; | ||
|
||
[Clever Cloud](https://clever-cloud.com) est une plateforme cloud européenne qui fournit des services automatisés et évolutifs. | ||
|
||
## Configuration du projet | ||
|
||
Vous pouvez déployer à la fois des projets Astro entièrement statiques ou rendus à la demande sur Clever Cloud. Quel que soit votre mode de sortie ([pré-rendu ou à la demande](/fr/basics/rendering-modes/)), vous pouvez choisir de déployer en tant qu'**application statique** qui s'exécute à l'aide d'un hook de post-construction, ou en tant qu'application **Node.js**, qui fonctionne immédiatement avec votre fichier `package.json`. | ||
|
||
### Port et hôte | ||
|
||
Les applications sur Clever Cloud écoutent sur le port **8080**. Si votre projet nécessite cette configuration, définissez votre port et votre hôte dans Astro à l'un des deux emplacements suivants : | ||
|
||
1. Dans les scripts `package.json` : | ||
|
||
```json title="package.json" "astro preview --host 0.0.0.0 --port 8080" | ||
"scripts": { | ||
"dev": "astro dev", | ||
"start": "astro dev", | ||
"build": "astro check && astro build", | ||
"preview": "astro preview --host 0.0.0.0 --port 8080", | ||
"astro": "astro" | ||
} | ||
``` | ||
|
||
2. Dans `astro.config.mjs` : | ||
|
||
```javascript title="astro.config.mjs" | ||
import { defineConfig } from 'astro/config'; | ||
|
||
export default defineConfig({ | ||
server: { | ||
port: 8080, | ||
host: true | ||
} | ||
}); | ||
``` | ||
|
||
|
||
## Déployer Astro depuis la console | ||
|
||
Pour déployer votre projet Astro sur Clever Cloud, vous devez **créer une nouvelle application**. L'assistant d'application vous guidera tout au long des étapes de configuration nécessaires. | ||
|
||
<Steps> | ||
|
||
1. Dans la barre de menu latérale, cliquez sur **Créer** > **Une application** | ||
2. Choisissez comment déployer : | ||
|
||
- **Créer une toute nouvelle application** : pour déployer à partir d'un dépôt local avec Git | ||
|
||
ou | ||
|
||
- **Sélectionnez un dépôt GitHub** : pour déployer à partir de GitHub | ||
|
||
3. Sélectionnez une application **Node.js** ou une application **statique**. | ||
4. Définissez la taille minimale de votre instance et les options d'évolutivité. Les sites Astro peuvent généralement être déployés à l'aide de l'instance **Nano**. En fonction des spécifications et des dépendances de votre projet, vous devrez peut-être effectuer des ajustements en conséquence lorsque vous consultez les métriques de la page **Présentation**. | ||
5. Sélectionnez une **région** pour déployer votre instance. | ||
6. Ignorez [la connexion des **modules complémentaires** à votre application Clever](https://developers.clever-cloud.com/doc/addons/) sauf si vous utilisez une base de données ou Keycloak. | ||
7. Injectez des **variables d’environnement** : | ||
|
||
- Pour **Node.js**, aucune variable d'environnement spécifique n'est nécessaire pour déployer Astro si vous utilisez **npm**. Si vous utilisez **yarn** ou **pnpm**, définissez les variables d'environnement suivantes : | ||
|
||
<Tabs> | ||
<TabItem label="pnpm"> | ||
```shell | ||
CC_NODE_BUILD_TOOL="custom" | ||
CC_PRE_BUILD_HOOK="npm install -g pnpm && pnpm install" | ||
CC_CUSTOM_BUILD_TOOL="pnpm run astro telemetry disable && pnpm build" | ||
CC_RUN_COMMAND="pnpm run preview" | ||
``` | ||
</TabItem> | ||
<TabItem label="yarn"> | ||
```shell | ||
CC_NODE_BUILD_TOOL="yarn" | ||
CC_PRE_BUILD_HOOK="yarn && yarn run astro telemetry disable && yarn build" | ||
CC_RUN_COMMAND="yarn run preview" | ||
``` | ||
</TabItem> | ||
</Tabs> | ||
|
||
- Pour une application **statique**, ajoutez ces variables : | ||
|
||
<Tabs> | ||
<TabItem label="npm"> | ||
```shell | ||
CC_POST_BUILD_HOOK="npm run build" | ||
CC_PRE_BUILD_HOOK="npm install && npm run astro telemetry disable" | ||
CC_WEBROOT="/dist" | ||
``` | ||
</TabItem> | ||
<TabItem label="pnpm"> | ||
```shell | ||
CC_POST_BUILD_HOOK="pnpm build" | ||
CC_PRE_BUILD_HOOK="npm install -g pnpm && pnpm install && pnpm run astro telemetry disable" | ||
CC_WEBROOT="/dist" | ||
``` | ||
</TabItem> | ||
<TabItem label="yarn"> | ||
```shell | ||
CC_POST_BUILD_HOOK="yarn build" | ||
CC_PRE_BUILD_HOOK="yarn && yarn run astro telemetry disable" | ||
CC_WEBROOT="/dist" | ||
``` | ||
</TabItem> | ||
</Tabs> | ||
|
||
|
||
8. **Déployer !** Si vous effectuez un déploiement à partir de **GitHub**, votre déploiement doit démarrer automatiquement. Si vous utilisez **Git**, copiez le dépôt distant et effectuez un push sur la branche **master**. | ||
|
||
</Steps> | ||
|
||
:::tip[Autres branches] | ||
Pour déployer à partir de branches autres que `master`, utilisez `git push clever <branch>:master`. | ||
|
||
Par exemple, si vous souhaitez déployer votre branche locale `main` sans la renommer, utilisez `git push clever main:master`. | ||
::: | ||
|
||
|
||
## Ressources officielles | ||
- [Documentation Clever Cloud pour déployer une application Node.js](https://developers.clever-cloud.com/doc/applications/javascript/nodejs/) | ||
- [Documentation Clever Cloud pour le déploiement d'Astro en tant qu'application statique](https://developers.clever-cloud.com/guides/astro/) |