


Deploying a Client-Side Rendered create-react-app to Microsoft Azure
Deploying a React application to Microsoft Azure appears straightforward, but hidden complexities exist. This guide focuses on deploying create-react-app (or similar front-end frameworks using pushState routing) to Azure, minimizing client-server routing conflicts.
A brief anecdote illustrates the challenges: In a previous project with a React front-end and ASP.NET Core back-end deployed separately to Azure, page refreshes resulted in 404 errors due to routing misconfigurations. This highlighted the need for proper server-side configuration to handle client-side routing.
Production-Ready React Builds
Building a React app for production (using npm run build
) creates an optimized build
folder containing static assets. Deploying this folder to a server is sufficient for a live application. The structure typically resembles:
<code>→ build → static → css → css files → js → js files → media → media files → index.html → other files...</code>
Client-Side Routing with React Router
React Router leverages the HTML5 pushState API. PushState updates the URL without a full page reload, enabling client-side routing. However, this presents challenges when deploying to a server. A standard server expects to find files matching the URL path; with client-side routing, this isn't the case. The server must be configured to serve index.html
for all routes.
Express.js, for example, requires this configuration:
app.get('*', (req, res) => { res.sendFile(path.resolve(__dirname, 'client', 'build', 'index.html')); });
This assumes the React app is hosted at the server root. For separate front-end and back-end projects, this approach is problematic. Since we're deploying a static app, a back-end isn't strictly necessary.
Azure App Service Deployment
To deploy to Azure:
- Create a new App Service in the Azure portal.
- Navigate to the Deployment Center. We'll use Local Git with Kudu as the build provider.
- Azure provides a Git remote URL; clone this locally.
- After building the React app (
npm run build
), initialize a Git repository in thebuild
folder, commit changes, and push to the Azure remote.
Crucially, ensure your package.json
specifies a supported Node.js version for Azure (check available versions using az webapp list-runtimes
). Add a line like "engines": {"node": "10.0"}
.
The initial deployment may fail on page refreshes due to the 404 error.
Reconciling Client-Server Routing in Azure
To resolve this, add a web.config
file to the build
folder:
<?xml version="1.0"?> <configuration> <system.webserver> <rewrite> <rules> <rule name="React Routes" stopprocessing="true"> <match url=".*"></match> <conditions logicalgrouping="MatchAll"> <add input="{REQUEST_FILENAME}" matchtype="IsFile" negate="true"></add> <add input="{REQUEST_FILENAME}" matchtype="IsDirectory" negate="true"></add> <add input="{REQUEST_URI}" negate="true" pattern="^/(api)"></add> </conditions> <action type="Rewrite" url="/"></action> </rule> </rules> </rewrite> </system.webserver> </configuration>
Rebuild and redeploy. The application should now function correctly. For continuous deployment, explore Azure's continuous integration/continuous deployment (CI/CD) features.
Conclusion
Azure offers robust capabilities for deploying React applications. Understanding client-server routing interactions is key to successful deployments. Further resources on Kudu, Node.js deployment, and static site deployment on Azure are recommended for deeper understanding.
The above is the detailed content of Deploying a Client-Side Rendered create-react-app to Microsoft Azure. For more information, please follow other related articles on the PHP Chinese website!

Hot AI Tools

Undress AI Tool
Undress images for free

Undresser.AI Undress
AI-powered app for creating realistic nude photos

AI Clothes Remover
Online AI tool for removing clothes from photos.

Clothoff.io
AI clothes remover

Video Face Swap
Swap faces in any video effortlessly with our completely free AI face swap tool!

Hot Article

Hot Tools

Notepad++7.3.1
Easy-to-use and free code editor

SublimeText3 Chinese version
Chinese version, very easy to use

Zend Studio 13.0.1
Powerful PHP integrated development environment

Dreamweaver CS6
Visual web development tools

SublimeText3 Mac version
God-level code editing software (SublimeText3)

Backdrop-filter is used to apply visual effects to the content behind the elements. 1. Use backdrop-filter:blur(10px) and other syntax to achieve the frosted glass effect; 2. Supports multiple filter functions such as blur, brightness, contrast, etc. and can be superimposed; 3. It is often used in glass card design, and it is necessary to ensure that the elements overlap with the background; 4. Modern browsers have good support, and @supports can be used to provide downgrade solutions; 5. Avoid excessive blur values and frequent redrawing to optimize performance. This attribute only takes effect when there is content behind the elements.

First, use JavaScript to obtain the user system preferences and locally stored theme settings, and initialize the page theme; 1. The HTML structure contains a button to trigger topic switching; 2. CSS uses: root to define bright theme variables, .dark-mode class defines dark theme variables, and applies these variables through var(); 3. JavaScript detects prefers-color-scheme and reads localStorage to determine the initial theme; 4. Switch the dark-mode class on the html element when clicking the button, and saves the current state to localStorage; 5. All color changes are accompanied by 0.3 seconds transition animation to enhance the user

User agent stylesheets are the default CSS styles that browsers automatically apply to ensure that HTML elements that have not added custom styles are still basic readable. They affect the initial appearance of the page, but there are differences between browsers, which may lead to inconsistent display. Developers often solve this problem by resetting or standardizing styles. Use the Developer Tools' Compute or Style panel to view the default styles. Common coverage operations include clearing inner and outer margins, modifying link underscores, adjusting title sizes and unifying button styles. Understanding user agent styles can help improve cross-browser consistency and enable precise layout control.

Theaspect-ratioCSSpropertydefinesthewidth-to-heightratioofanelement,ensuringconsistentproportionsinresponsivedesigns.1.Itisapplieddirectlytoelementslikeimages,videos,orcontainersusingsyntaxsuchasaspect-ratio:16/9.2.Commonusecasesincludemaintainingres

The style of the link should distinguish different states through pseudo-classes. 1. Use a:link to set the unreached link style, 2. a:visited to set the accessed link, 3. a:hover to set the hover effect, 4. a:active to set the click-time style, 5. a:focus ensures keyboard accessibility, always follow the LVHA order to avoid style conflicts. You can improve usability and accessibility by adding padding, cursor:pointer and retaining or customizing focus outlines. You can also use border-bottom or animation underscore to ensure that the link has a good user experience and accessibility in all states.

vw and vh units achieve responsive design by associating element sizes with viewport width and height; 1vw is equal to 1% of viewport width, and 1vh is equal to 1% of viewport height; commonly used in full screen area, responsive fonts and elastic spacing; 1. Use 100vh or better 100dvh in the full screen area to avoid the influence of the mobile browser address bar; 2. Responsive fonts can be limited with 5vw and combined with clamp (1.5rem, 3vw, 3rem) to limit the minimum and maximum size; 3. Elastic spacing such as width:80vw, margin:5vhauto, padding:2vh3vw, can make the layout adaptable; pay attention to mobile device compatibility, accessibility and fixed width content conflicts, and it is recommended to give priority to using dvh first;

The:emptypseudo-classselectselementswithnochildrenorcontent,includingspacesorcomments,soonlytrulyemptyelementslikematchit;1.Itcanhideemptycontainersbyusing:empty{display:none;}tocleanuplayouts;2.Itallowsaddingplaceholderstylingvia::beforeor::after,wh

Define@keyframesbouncewith0%,100%attranslateY(0)and50%attranslateY(-20px)tocreateabasicbounce.2.Applytheanimationtoanelementusinganimation:bounce0.6sease-in-outinfiniteforsmooth,continuousmotion.3.Forrealism,use@keyframesrealistic-bouncewithscale(1.1
