Maison > Article > interface Web > Déploiement d'applications React : un guide d'utilisation des pages GitHub
De nombreux développeurs ont du mal à déployer des applications React, en particulier ceux qui ne connaissent pas l'écosystème. Vous pouvez héberger vos pages Web statiques, y compris les applications React, gratuitement et facilement en utilisant les pages GitHub. Le déploiement de vos applications React sur les pages GitHub sera facilité et sans tracas grâce à ce didacticiel détaillé, qui vous guidera à travers chaque étape du processus.
GitHub Pages est un service d'hébergement de sites statiques conçu pour héberger vos pages personnelles, d'organisation ou de projet directement à partir d'un référentiel GitHub. Il offre une intégration transparente avec votre flux de travail GitHub, ce qui en fait un choix idéal pour héberger des applications React.
Principaux avantages :
Gratuit et facile à utiliser.
Prend en charge les domaines personnalisés.
Construit et déploie automatiquement votre site.
Pour plus d'informations, consultez la documentation des pages GitHub.
Avant de déployer votre application React sur les pages GitHub, assurez-vous de disposer d'une application React fonctionnelle. Si vous n'en avez pas encore, vous pouvez créer une nouvelle application React à l'aide de Create React App (CRA).
npx create-react-app my-react-app cd my-react-app
Cette commande met en place un nouveau projet React avec toutes les configurations nécessaires.
Pour déployer une application React sur les pages GitHub, vous devez apporter quelques modifications à la configuration de votre application.
Installer le package de pages GitHub :
npm install gh-pages --save-dev
Mettre à jour package.json :
Ajoutez les champs suivants à votre fichier package.json :
"homepage": "https://<username>.github.io/<repository-name>", "scripts": { "predeploy": "npm run build", "deploy": "gh-pages -d build" }
Remplacez par votre nom d'utilisateur GitHub et par le nom de votre référentiel.
Allez sur GitHub et créez un nouveau référentiel.
Nommez votre référentiel et définissez-le sur public.
Ne pas initialiser avec un fichier README, .gitignore ou une licence, car ceux-ci seront ajoutés ultérieurement.
Maintenant que votre application React est prête et que vous disposez d'un référentiel GitHub, il est temps de la déployer.
Initialisez Git et envoyez-le vers GitHub :
git init git remote add origin https://github.com/<username>/<repository-name>.git git add . git commit -m "Initial commit" git push -u origin master
Déployez votre application :
npm run deploy
Cette commande construira votre application et la déploiera sur la branche gh-pages de votre référentiel.
Le déploiement d'applications React sur les pages GitHub peut parfois rencontrer des problèmes. Voici les problèmes courants et leurs solutions :
Erreurs 404 : assurez-vous que le champ de la page d'accueil dans package.json est correctement défini.
Échecs de build : vérifiez vos scripts de build et assurez-vous que toutes les dépendances sont installées.
Problèmes CORS : assurez-vous que vos points de terminaison d'API prennent en charge CORS si vous effectuez des requêtes d'origine croisée.
Pour plus de conseils de dépannage, reportez-vous au Guide de dépannage des pages GitHub.
GitHub Actions fournit de puissantes fonctionnalités CI/CD qui peuvent automatiser votre processus de déploiement. Voici comment le configurer :
Créer un fichier de flux de travail :
Dans votre référentiel, créez un fichier nommé .github/workflows/deploy.yml.
Ajouter un script de déploiement :
nom : Déployer l'application React sur les pages GitHub
on: push: branches: - master jobs: build-and-deploy: runs-on: ubuntu-latest steps: - name: Checkout code uses: actions/checkout@v2 - name: Set up Node.js uses: actions/setup-node@v2 with: node-version: '14' - name: Install dependencies run: npm install - name: Build the React app run: npm run build - name: Deploy to GitHub Pages uses: peaceiris/actions-gh-pages@v3 with: github_token: ${{ secrets.GITHUB_TOKEN }} publish_dir: ./build
Ce workflow déploiera automatiquement votre application React chaque fois que vous apporterez des modifications à la branche principale.
Au-delà des bases, il existe plusieurs techniques avancées que vous pouvez utiliser pour améliorer votre processus de déploiement :
Domaines personnalisés : vous pouvez utiliser un domaine personnalisé avec votre site GitHub Pages en ajoutant un fichier CNAME à votre référentiel.
Application HTTPS : assurez-vous que votre site est toujours servi via HTTPS en activant l'option HTTPS dans les paramètres de votre référentiel.
Déploiements de succursales : déployez à partir de différentes branches pour les environnements de transfert et de production.
Pour des informations détaillées, consultez le Guide des domaines personnalisés des pages GitHub.
Pour garantir un déploiement réussi et une expérience utilisateur de haute qualité, suivez ces bonnes pratiques :
Optimisez votre build : utilisez des outils tels que webpack et Babel pour optimiser vos bundles JavaScript.
Utiliser des variables d'environnement : gérez vos paramètres spécifiques à l'environnement à l'aide de variables d'environnement.
Surveiller les performances : utilisez des outils de surveillance des performances pour suivre et améliorer les performances de votre application déployée.
Pour plus de bonnes pratiques, reportez-vous au Guide de déploiement de React.
Le déploiement d'applications React sur les pages GitHub est un processus simple qui peut grandement simplifier l'hébergement et la gestion de vos sites Web statiques. En suivant les étapes décrites dans ce guide, vous pouvez garantir un processus de déploiement fluide et efficace.
En suivant ce guide, vous serez bien équipé pour déployer vos applications React sur les pages GitHub, en tirant parti de la puissance des capacités d'hébergement de GitHub pour diffuser vos applications dans le monde entier.
Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!