Kurs Next.js · Moduł 8: Deployment i produkcja
Przygotowanie aplikacji do produkcji (build, analyze)
W tej lekcji6
Przygotowanie aplikacji Next.js do wdrożenia produkcyjnego to kluczowy etap procesu rozwoju, który wymaga szczególnej uwagi do optymalizacji, analizy i konfiguracji. Odpowiednio przygotowana aplikacja zapewni lepsze wrażenia użytkownika, wyższą wydajność i łatwiejsze utrzymanie.
Proces budowania aplikacji Next.js
Proces budowania (build) w Next.js przekształca kod źródłowy w zoptymalizowaną wersję gotową do wdrożenia. Podczas tego procesu Next.js:
- Kompiluje kod React i TypeScript do JavaScript
- Minifikuje kod CSS i JavaScript
- Optymalizuje obrazy
- Generuje statyczne strony (dla getStaticProps)
- Przygotowuje komponenty serwerowe (dla getServerSideProps)
- Tworzy pliki konieczne do nawigacji po stronie klienta
Podstawowy proces budowania
Aby zbudować aplikację Next.js, wykonaj następujące kroki:
# Najpierw upewnij się, że wszystkie zależności są zainstalowane
npm install
# Następnie zbuduj aplikację
npm run buildPo zakończeniu procesu budowania, Next.js wyświetli zestawienie stron, ich typów (statyczne, SSR, API) oraz rozmiaru każdej strony. To podsumowanie dostarcza cennych informacji o wydajności aplikacji.
Uruchamianie zbudowanej aplikacji
Po pomyślnym zbudowaniu aplikacji możesz uruchomić wersję produkcyjną lokalnie za pomocą:
npm run startTen polecenie uruchamia serwer Node.js, który obsługuje twoją aplikację Next.js w trybie produkcyjnym, bez funkcji hot-reloading i z zoptymalizowanymi aktywami.
Analiza pakietu (bundle analysis)
Analiza rozmiaru pakietu jest niezbędna do zrozumienia, co dokładnie wpływa na wielkość twojej aplikacji. Next.js oferuje wbudowane narzędzie do analizy pakietu, które można włączyć za pomocą zmiennej środowiskowej:
ANALYZE=true npm run buildAby skorzystać z tej funkcji, należy zainstalować i skonfigurować narzędzie @next/bundle-analyzer:
npm install --save-dev @next/bundle-analyzerNastępnie zaktualizuj plik next.config.js:
const withBundleAnalyzer = require('@next/bundle-analyzer')({
enabled: process.env.ANALYZE === 'true',
})
module.exports = withBundleAnalyzer({
// Tutaj umieść pozostałe opcje konfiguracyjne Next.js
})Po uruchomieniu budowy z włączonym analizatorem, wygenerowane zostaną wizualne raporty pokazujące szczegółowy rozkład rozmiaru pakietu klienta i serwera.
Interpretacja wyników analizy pakietu
Analiza pakietu ujawnia:
- Duże zależności - biblioteki, które znacząco wpływają na rozmiar pakietu
- Duplikaty - te same pakiety załadowane kilkakrotnie
- Nieużywany kod - martwy kod, który można usunąć
- Rozkład modułów - które części aplikacji zajmują najwięcej miejsca
Na podstawie tych informacji możesz podjąć świadome decyzje dotyczące optymalizacji:
- Zastąpić duże biblioteki lżejszymi alternatywami
- Zaimplementować ładowanie leniwe dla dużych komponentów
- Usunąć nieużywane zależności
- Podzielić kod na mniejsze kawałki
Optymalizacja wydajności
Code splitting
Next.js automatycznie implementuje podział kodu, ale możesz dodatkowo zoptymalizować ten proces, używając dynamicznego importu:
import dynamic from 'next/dynamic';
// Zamiast importować bezpośrednio
// import HeavyComponent from '../components/HeavyComponent';
// Użyj dynamicznego importu
const HeavyComponent = dynamic(() => import('../components/HeavyComponent'), {
loading: () => <p>Ładowanie...</p>,
// SSR można wyłączyć dla komponentów, które nie są potrzebne na serwerze
ssr: false,
});
export default function HomePage() {
return (
<div>
<h1>Strona główna</h1>
<HeavyComponent />
</div>
);
}Optymalizacja obrazów
Next.js oferuje komponent Image, który automatycznie optymalizuje obrazy, ale warto dodatkowo skonfigurować opcje:
import Image from 'next/image';
export default function ProductCard({ product }) {
return (
<div>
<Image
src={product.imageUrl}
alt={product.name}
width={300}
height={200}
placeholder="blur"
blurDataURL={product.thumbnailUrl}
priority={product.featured} // Ładuje obraz z wysokim priorytetem, jeśli jest wyróżniony
/>
<h2>{product.name}</h2>
</div>
);
}Tree shaking
Tree shaking to technika eliminacji martwego kodu podczas budowania. Next.js korzysta z Webpack, który wykonuje tree shaking automatycznie. Aby maksymalizować korzyści z tree shaking:
- Używaj importów ES Modules zamiast require
- Unikaj importów typu side-effect (np.
import 'library') - Preferuj importy nazwane zamiast domyślnych, gdy potrzebujesz tylko części biblioteki:
// Źle: importuje całą bibliotekę
import _ from 'lodash';
const sortedItems = _.sortBy(items, 'name');
// Dobrze: importuje tylko potrzebną funkcję
import { sortBy } from 'lodash-es';
const sortedItems = sortBy(items, 'name');Zmienne środowiskowe
Next.js obsługuje zmienne środowiskowe poprzez pliki .env, .env.local, .env.development i .env.production. Są one kluczowe do konfiguracji aplikacji w różnych środowiskach.
# .env.production
NEXT_PUBLIC_API_URL=https://api.twojadomena.com
DATABASE_URL=postgresql://user:password@production-db:5432/mydb
FEATURE_FLAGS_ENABLED=trueZmienne prefixowane NEXT_PUBLIC_ są dostępne w przeglądarce, podczas gdy pozostałe są widoczne tylko na serwerze.
Bezpieczne zarządzanie sekretami
Dla sekretów produkcyjnych:
- Nigdy nie umieszczaj sekretów w repozytorium
- Używaj zarządzania sekretami platformy hostingowej (Vercel, Netlify)
- Dla wrażliwych operacji, preferuj kod po stronie serwera (API Routes)
// pages/api/secure-operation.ts
export default async function handler(req, res) {
// API_SECRET jest niedostępny w kodzie klienta
const apiSecret = process.env.API_SECRET;
// Bezpieczne wykonanie operacji z sekretem
const result = await performSecureOperation(apiSecret);
// Zwróć tylko bezpieczne dane
res.status(200).json({ success: true, data: result.safeData });
}Testowanie produkcyjne
Przed wdrożeniem, przeprowadź testy wersji produkcyjnej:
- Testy wydajnościowe - użyj Lighthouse lub WebPageTest
- Testy funkcjonalne - sprawdź, czy wszystkie funkcje działają zgodnie z oczekiwaniami
- Testy responsywności - sprawdź różne rozmiary ekranu
- Testy przeglądarek - sprawdź kompatybilność z różnymi przeglądarkami
Automatyzacja testów przedprodukcyjnych
Skonfiguruj skrypt, który przeprowadzi wszystkie niezbędne testy:
// scripts/pre-deploy-checks.js
const { execSync } = require('child_process');
// Uruchom testy jednostkowe
console.log('Uruchamianie testów jednostkowych...');
execSync('npm run test', { stdio: 'inherit' });
// Uruchom testy end-to-end
console.log('Uruchamianie testów E2E...');
execSync('npm run test:e2e', { stdio: 'inherit' });
// Sprawdź typy
console.log('Sprawdzanie typów...');
execSync('npm run typecheck', { stdio: 'inherit' });
// Sprawdź lintowanie
console.log('Sprawdzanie lintingu...');
execSync('npm run lint', { stdio: 'inherit' });
// Zbuduj aplikację
console.log('Budowanie aplikacji...');
execSync('npm run build', { stdio: 'inherit' });
console.log('Wszystkie sprawdzenia przedwdrożeniowe przeszły pomyślnie!');Podsumowanie
Przygotowanie aplikacji Next.js do produkcji to wieloetapowy proces, który obejmuje:
- Budowanie zoptymalizowanej wersji aplikacji
- Analizę pakietu w celu identyfikacji możliwości optymalizacji
- Implementację technik poprawiających wydajność
- Konfigurację zmiennych środowiskowych
- Bezpieczne zarządzanie sekretami
- Testowanie produkcyjne
Starannie przeprowadzony proces przygotowania aplikacji do produkcji zapewnia lepszą wydajność, bezpieczeństwo i doświadczenie użytkownika, co przekłada się na sukces biznesowy projektu.
Pamiętaj, że optymalizacja jest procesem ciągłym - regularne monitorowanie wydajności i aktualizowanie aplikacji zgodnie z nowymi najlepszymi praktykami to klucz do utrzymania wydajnej aplikacji.
Kod do tej lekcji: App.tsx
// Demo: Przygotowanie aplikacji Next.js do produkcji
// Build process, optymalizacja, checklist deployment
import React, { useState } from 'react';
// Proces budowania Next.js:
// 1. npm run build → next build
// - Kompiluje TypeScript
// - Generuje statyczne strony (SSG)
// - Optymalizuje bundle (tree shaking, code splitting)
// - Generuje sitemap, robots.txt
// 2. npm run start → next start
// - Uruchamia production server
// - Serwuje statyczne pliki z .next/
// - Obsługuje SSR i ISR
interface ChecklistItem {
id: string;
category: string;
title: string;
description: string;
impact: 'critical' | 'high' | 'medium';
command?: string;
}
const checklist: ChecklistItem[] = [
{
id: '1', category: 'Build', title: 'Build bez błędów',
description: 'npm run build musi zakończyć się sukcesem',
impact: 'critical', command: 'npm run build',
},
{
id: '2', category: 'Build', title: 'TypeScript - brak błędów typów',
description: 'Strict mode, zero any warnings',
impact: 'critical', command: 'npx tsc --noEmit',
},
{
id: '3', category: 'Build', title: 'Linting',
description: 'ESLint bez ostrzeżeń i błędów',
impact: 'high', command: 'npm run lint',
},
{
id: '4', category: 'Performance', title: 'Bundle analysis',
description: 'Sprawdź rozmiar bundli, usuń nieużywane zależności',
impact: 'high', command: 'ANALYZE=true npm run build',
},
{
id: '5', category: 'Performance', title: 'Image optimization',
description: 'Użyj next/image, WebP/AVIF, lazy loading',
impact: 'high',
},
{
id: '6', category: 'Performance', title: 'Font optimization',
description: 'Użyj next/font, self-hosting, font-display: swap',
impact: 'medium',
},
{
id: '7', category: 'SEO', title: 'Metadata na każdej stronie',
description: 'title, description, Open Graph dla social sharing',
impact: 'high',
},
{
id: '8', category: 'SEO', title: 'sitemap.xml i robots.txt',
description: 'Automatyczna generacja w app/sitemap.ts i app/robots.ts',
impact: 'medium',
},
{
id: '9', category: 'Security', title: 'Environment variables',
description: 'Sekrety w .env.local, NEXT_PUBLIC_ tylko dla publicznych',
impact: 'critical',
},
{
id: '10', category: 'Security', title: 'Headers bezpieczeństwa',
description: 'CSP, X-Frame-Options, HSTS w next.config.js',
impact: 'high',
},
{
id: '11', category: 'Deploy', title: 'Wybór platformy',
description: 'Vercel (najlepsze), Netlify, AWS, Docker',
impact: 'high',
},
{
id: '12', category: 'Deploy', title: 'CI/CD pipeline',
description: 'GitHub Actions: build → test → deploy',
impact: 'medium',
},
];
const impactColors = { critical: '#f44336', high: '#ff9800', medium: '#64ffda' };
const categories = [...new Set(checklist.map(c => c.category))];
function BuildOutput() {
const routes = [
{ path: '/', type: 'Static', size: '5.2 kB' },
{ path: '/products', type: 'SSG', size: '12.4 kB' },
{ path: '/products/[id]', type: 'SSG', size: '8.7 kB' },
{ path: '/dashboard', type: 'SSR', size: '15.1 kB' },
{ path: '/api/health', type: 'API', size: '1.2 kB' },
];
const typeIcons: Record<string, string> = {
Static: 'S', SSG: 'G', SSR: 'R', API: 'A',
};
const typeColors: Record<string, string> = {
Static: '#7c4dff', SSG: '#64ffda', SSR: '#ff9800', API: '#2196f3',
};
return (
<div style={{
background: 'rgba(0,0,0,0.3)', borderRadius: '8px', padding: '16px',
}}>
<h4 style={{ color: '#64ffda', marginBottom: '8px', fontSize: '0.85rem' }}>
$ next build
</h4>
<div style={{ display: 'grid', gap: '4px' }}>
{routes.map(r => (
<div key={r.path} style={{
display: 'flex', alignItems: 'center', gap: '10px',
padding: '6px 8px', fontFamily: 'monospace', fontSize: '0.8rem',
}}>
<span style={{
width: '20px', height: '20px', borderRadius: '4px',
background: typeColors[r.type], color: '#0f0f23',
display: 'flex', alignItems: 'center', justifyContent: 'center',
fontSize: '0.7rem', fontWeight: 'bold', flexShrink: 0,
}}>{typeIcons[r.type]}</span>
<span style={{ color: '#b0bec5', flex: 1 }}>{r.path}</span>
<span style={{ color: '#78909c' }}>{r.size}</span>
</div>
))}
</div>
<div style={{
marginTop: '12px', padding: '8px', borderTop: '1px solid rgba(255,255,255,0.05)',
display: 'flex', justifyContent: 'space-between',
}}>
<span style={{ color: '#4caf50', fontSize: '0.8rem' }}>Build completed in 12.4s</span>
<span style={{ color: '#78909c', fontSize: '0.8rem' }}>Total: 42.6 kB</span>
</div>
</div>
);
}
export default function ProductionChecklist() {
const [completed, setCompleted] = useState<Set<string>>(new Set());
const [activeCategory, setActiveCategory] = useState('all');
const toggle = (id: string) => {
setCompleted(prev => {
const next = new Set(prev);
if (next.has(id)) next.delete(id); else next.add(id);
return next;
});
};
const filtered = activeCategory === 'all'
? checklist
: checklist.filter(c => c.category === activeCategory);
const progress = Math.round((completed.size / checklist.length) * 100);
return (
<div style={{
background: '#0f0f23', minHeight: '100vh', padding: '24px',
color: '#fff', fontFamily: 'system-ui, sans-serif',
}}>
<h1 style={{ color: '#64ffda', marginBottom: '4px' }}>Production Checklist</h1>
<p style={{ color: '#b0bec5', marginBottom: '16px' }}>
Przygotowanie aplikacji Next.js do wdrożenia
</p>
<div style={{
background: 'rgba(100,255,218,0.05)', borderRadius: '10px',
padding: '12px 16px', marginBottom: '20px',
display: 'flex', alignItems: 'center', gap: '16px',
}}>
<div style={{
width: '48px', height: '48px', borderRadius: '50%',
background: `conic-gradient(#64ffda ${progress * 3.6}deg, rgba(255,255,255,0.05) 0deg)`,
display: 'flex', alignItems: 'center', justifyContent: 'center',
}}>
<span style={{ color: '#64ffda', fontWeight: 'bold', fontSize: '0.8rem' }}>{progress}%</span>
</div>
<div>
<p style={{ color: '#fff', margin: 0, fontWeight: 600 }}>{completed.size}/{checklist.length} completed</p>
<p style={{ color: '#78909c', margin: 0, fontSize: '0.8rem' }}>
{progress === 100 ? 'Ready to deploy!' : 'Complete all checks before deploying'}
</p>
</div>
</div>
<div style={{ display: 'flex', gap: '8px', marginBottom: '16px' }}>
<button onClick={() => setActiveCategory('all')} style={{
background: activeCategory === 'all' ? '#64ffda' : 'transparent',
color: activeCategory === 'all' ? '#0f0f23' : '#b0bec5',
border: '1px solid rgba(100,255,218,0.3)',
padding: '6px 12px', borderRadius: '20px', cursor: 'pointer',
}}>All</button>
{categories.map(c => (
<button key={c} onClick={() => setActiveCategory(c)} style={{
background: activeCategory === c ? '#64ffda' : 'transparent',
color: activeCategory === c ? '#0f0f23' : '#b0bec5',
border: '1px solid rgba(100,255,218,0.3)',
padding: '6px 12px', borderRadius: '20px', cursor: 'pointer',
}}>{c}</button>
))}
</div>
<div style={{ display: 'grid', gap: '8px', marginBottom: '20px' }}>
{filtered.map(item => (
<div key={item.id} onClick={() => toggle(item.id)} style={{
display: 'flex', alignItems: 'center', gap: '12px',
background: completed.has(item.id) ? 'rgba(76,175,80,0.05)' : 'rgba(255,255,255,0.02)',
border: `1px solid ${completed.has(item.id) ? 'rgba(76,175,80,0.2)' : 'rgba(255,255,255,0.06)'}`,
borderRadius: '8px', padding: '12px', cursor: 'pointer',
}}>
<div style={{
width: '22px', height: '22px', borderRadius: '6px',
border: `2px solid ${completed.has(item.id) ? '#4caf50' : 'rgba(255,255,255,0.2)'}`,
background: completed.has(item.id) ? '#4caf50' : 'transparent',
display: 'flex', alignItems: 'center', justifyContent: 'center',
color: '#fff', fontSize: '0.7rem', flexShrink: 0,
}}>
{completed.has(item.id) ? 'V' : ''}
</div>
<div style={{ flex: 1 }}>
<div style={{ display: 'flex', alignItems: 'center', gap: '8px' }}>
<span style={{
color: completed.has(item.id) ? '#78909c' : '#fff',
textDecoration: completed.has(item.id) ? 'line-through' : 'none',
}}>{item.title}</span>
<span style={{
background: `${impactColors[item.impact]}15`,
color: impactColors[item.impact],
padding: '1px 8px', borderRadius: '10px', fontSize: '0.65rem',
}}>{item.impact}</span>
</div>
<p style={{ color: '#78909c', fontSize: '0.8rem', margin: '2px 0 0' }}>{item.description}</p>
</div>
</div>
))}
</div>
<BuildOutput />
</div>
);
}Hasła z dokumentacji w tej lekcji
Widzisz błąd w tej lekcji?
Sprawdź się
Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.
1. Komenda 'npm run build' w Next.js:
2. Bundle analyzer w Next.js służy do:
To 2 z 3 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Edytor kodu
Zbuduj interfejs z optymalizacją bundle size i lazy loading
- Klikanie w kolejności
Ułóż elementy w prawidłowej kolejności: npm → install → @next/bundle-analyzer