Kurs Next.js · Moduł 8: Deployment i produkcja
Preview Deployments i środowiska staging
W tej lekcji6
W Metropolii Quantum 2150 żaden system nie trafia bezpośrednio na serwery produkcyjne. Każda zmiana przechodzi przez rygorystyczny proces weryfikacji - od preview deployments dla poszczególnych Pull Requestów, przez środowisko staging, aż po kontrolowaną promocję na produkcję. Taki pipeline zapewnia, że mieszkańcy Quantum City nigdy nie doświadczą wadliwego kodu.
Czym są Preview Deployments?
Preview Deployments to automatyczne wdrożenia aplikacji generowane dla każdego Pull Requesta. Każdy PR otrzymuje własny, unikalny URL, pod którym można przetestować zmiany przed ich zmergowaniem do głównej gałęzi.
Vercel - platforma stworzona przez twórców Next.js - oferuje najlepsze wsparcie dla Preview Deployments. Ale inne platformy, jak Netlify czy AWS Amplify, również wspierają ten koncept.
Jak działają Preview Deployments na Vercel?
- Tworzysz Pull Request na GitHubie
- Vercel automatycznie wykrywa nowy PR
- Buduje aplikację z kodem z tego PR
- Generuje unikalny URL (np.
project-git-feature-xyz-team.vercel.app) - Dodaje komentarz do PR z linkiem do preview
# Przykładowe URL-e Preview Deployments:
# PR #42: my-app-git-feature-login-myteam.vercel.app
# PR #43: my-app-git-fix-header-myteam.vercel.app
# PR #44: my-app-git-update-api-myteam.vercel.app
# Każdy URL jest unikalny i działa dopóki PR istniejeKonfiguracja Vercel dla Preview Deployments
// vercel.json
{
"git": {
"deploymentEnabled": {
"main": true,
"staging": true
}
},
"github": {
"autoAlias": true,
"autoJobCancelation": true,
"silent": false
},
"headers": [
{
"source": "/(.*)",
"headers": [
{
"key": "X-Robots-Tag",
"value": "noindex"
}
]
}
]
}Ważna uwaga: Preview Deployments powinny mieć nagłówek X-Robots-Tag: noindex, aby wyszukiwarki nie indeksowały wersji testowych!
Środowiska deployment (dev → staging → prod)
W profesjonalnych projektach stosuje się wielopoziomowy pipeline wdrożeń:
Hierarchia środowisk
Development (dev) → Lokalna maszyna developera
↓
Preview → Automatyczne per-PR (Vercel Preview)
↓
Staging → Odwzorowanie produkcji (testy końcowe)
↓
Production (prod) → Serwery produkcyjne (użytkownicy końcowi)Branch-based deployments
Każda gałąź Gita może być mapowana na inne środowisko:
# Konfiguracja branch → environment w Vercel:
# main → Production (app.quantum-city.com)
# staging → Staging (staging.quantum-city.com)
# develop → Development (dev.quantum-city.com)
# feature/* → Preview (auto-generated URL)
# Workflow developera:
git checkout -b feature/new-dashboard
# ... kodowanie ...
git push origin feature/new-dashboard
# → Automatycznie: Preview Deployment!
# Po review i merge do staging:
git checkout staging
git merge feature/new-dashboard
git push origin staging
# → Automatycznie: Staging Deployment!
# Po testach na staging, merge do main:
git checkout main
git merge staging
git push origin main
# → Automatycznie: Production Deployment!Zmienne środowiskowe per environment
Każde środowisko ma własne zmienne:
// Vercel CLI - dodawanie zmiennych per środowisko
// vercel env add DATABASE_URL development
// vercel env add DATABASE_URL preview
// vercel env add DATABASE_URL production
// W kodzie sprawdzamy środowisko:
// app/api/config/route.ts
import { NextResponse } from 'next/server';
export async function GET() {
const environment = process.env.VERCEL_ENV; // 'production' | 'preview' | 'development'
const gitBranch = process.env.VERCEL_GIT_COMMIT_REF; // np. 'feature/login'
const commitSha = process.env.VERCEL_GIT_COMMIT_SHA; // hash commitu
return NextResponse.json({
environment,
branch: gitBranch,
commit: commitSha?.slice(0, 7),
// Różne bazy danych per środowisko
database: environment === 'production'
? 'prod-cluster'
: environment === 'preview'
? 'preview-cluster'
: 'dev-cluster',
});
}Protected Deployments
W środowisku staging i preview warto chronić dostęp, aby niepowołane osoby nie widziały nieopublikowanych zmian:
// middleware.ts - ochrona preview i staging
import { NextRequest, NextResponse } from 'next/server';
export function middleware(request: NextRequest) {
const environment = process.env.VERCEL_ENV;
// Nie chronij produkcji
if (environment === 'production') {
return NextResponse.next();
}
// Sprawdź autoryzację dla preview/staging
const authHeader = request.headers.get('authorization');
const previewToken = process.env.PREVIEW_ACCESS_TOKEN;
// Pozwól na dostęp z tokenem lub ciasteczkiem
const hasToken = authHeader === 'Bearer ' + previewToken;
const hasCookie = request.cookies.get('preview-access')?.value === previewToken;
if (!hasToken && !hasCookie) {
// Przekieruj na stronę logowania preview
return NextResponse.redirect(new URL('/preview-login', request.url));
}
return NextResponse.next();
}
export const config = {
matcher: ['/((?!preview-login|api|_next/static|favicon.ico).*)'],
};Deployment Hooks - automatyzacja wdrożeń
Deploy Hooks to URL-e webhooka, które wyzwalają nowe wdrożenie po wywołaniu:
# Tworzenie Deploy Hook w Vercel:
# Settings → Git → Deploy Hooks
# Nazwa: "CMS Content Update"
# Branch: main
# → Generuje URL: https://api.vercel.com/v1/integrations/deploy/prj_xxx/yyy
# Użycie z CMS (np. po publikacji artykułu):
curl -X POST https://api.vercel.com/v1/integrations/deploy/prj_xxx/yyy
# Użycie w GitHub Actions:
# - name: Trigger Vercel Deploy
# run: curl -X POST ${{ secrets.VERCEL_DEPLOY_HOOK }}
# Użycie z Strapi/Sanity webhook:
# Po opublikowaniu treści → POST na Deploy Hook URL
# → Vercel przebudowuje stronę z nowymi danymi (ISR/SSG)Praktyczny workflow z Deploy Hooks
// app/api/webhook/cms/route.ts
import { NextRequest, NextResponse } from 'next/server';
export async function POST(request: NextRequest) {
// Weryfikacja webhooka z CMS
const signature = request.headers.get('x-webhook-signature');
const secret = process.env.CMS_WEBHOOK_SECRET;
if (!verifySignature(signature, secret)) {
return NextResponse.json({ error: 'Invalid signature' }, { status: 401 });
}
// Wyzwól rewalidację lub nowy deploy
const deployHookUrl = process.env.VERCEL_DEPLOY_HOOK;
if (deployHookUrl) {
await fetch(deployHookUrl, { method: 'POST' });
return NextResponse.json({ status: 'Deploy triggered' });
}
return NextResponse.json({ status: 'No deploy hook configured' });
}
function verifySignature(signature: string | null, secret: string | undefined): boolean {
if (!signature || !secret) return false;
// Implementacja weryfikacji HMAC
return true;
}Environment Promotion (dev → staging → prod)
Promocja środowisk to kontrolowany proces przenoszenia kodu między środowiskami:
# Strategia 1: Git-flow z automatycznym deploy
# develop → auto-deploy na dev
# staging → auto-deploy na staging
# main → auto-deploy na production
# Merge workflow:
git checkout staging
git merge develop # Promuj dev → staging
git push origin staging # Auto-deploy na staging
# Po testach na staging:
git checkout main
git merge staging # Promuj staging → prod
git push origin main # Auto-deploy na production
# Strategia 2: Vercel Promote (bez merge)
# Vercel pozwala promować istniejący deployment:
vercel promote [deployment-url] --scope=team
# To przenosi DOKŁADNIE ten sam build na produkcję
# Bez ponownego budowania - gwarancja identyczności!Podsumowanie
Preview Deployments i środowiska staging to fundamenty profesjonalnego procesu wdrożeń:
- Preview Deployments - automatyczne wdrożenia per PR, idealne do code review
- Branch-based deployments - mapowanie gałęzi na środowiska (dev/staging/prod)
- Environment promotion - kontrolowany przepływ kodu między środowiskami
- Protected Deployments - ochrona preview i staging przed nieautoryzowanym dostępem
- Deploy Hooks - automatyczne wyzwalanie wdrożeń z CMS lub CI/CD
W Metropolii Quantum 2150 żaden system nie przechodzi do produkcji bez pełnego cyklu preview → staging → production. To gwarantuje stabilność i jakość usług dla wszystkich mieszkańców cyberpunkowego miasta.
Kod do tej lekcji: App.tsx
import React, { useState } from 'react';
// Demo: Preview Deployments i srodowiska staging
interface Deployment {
id: string;
branch: string;
env: 'production' | 'staging' | 'preview';
url: string;
status: 'ready' | 'building' | 'error';
pr?: number;
commit: string;
age: string;
}
const deployments: Deployment[] = [
{ id: '1', branch: 'main', env: 'production', url: 'app.quantum-city.com', status: 'ready', commit: 'a1b2c3d', age: '2h ago' },
{ id: '2', branch: 'staging', env: 'staging', url: 'staging.quantum-city.com', status: 'ready', commit: 'e4f5g6h', age: '1h ago' },
{ id: '3', branch: 'feature/new-dashboard', env: 'preview', url: 'app-git-feature-new-dashboard-team.vercel.app', status: 'ready', pr: 42, commit: 'i7j8k9l', age: '30m ago' },
{ id: '4', branch: 'fix/header-layout', env: 'preview', url: 'app-git-fix-header-layout-team.vercel.app', status: 'building', pr: 43, commit: 'm0n1o2p', age: '5m ago' },
{ id: '5', branch: 'feature/auth-update', env: 'preview', url: 'app-git-feature-auth-team.vercel.app', status: 'error', pr: 44, commit: 'q3r4s5t', age: '15m ago' },
];
const envColors: Record<string, string> = { production: '#4caf50', staging: '#ff9800', preview: '#7c3aed' };
const statusColors: Record<string, string> = { ready: '#4caf50', building: '#2196f3', error: '#f44336' };
const pipeline = [
{ name: 'Development', desc: 'Lokalna maszyna', icon: '1' },
{ name: 'Preview', desc: 'Auto per PR', icon: '2' },
{ name: 'Staging', desc: 'Testy koncowe', icon: '3' },
{ name: 'Production', desc: 'Uzytkownicy', icon: '4' },
];
export default function PreviewDeploymentsDemo() {
const [filter, setFilter] = useState<'all' | 'production' | 'staging' | 'preview'>('all');
const [showPipeline, setShowPipeline] = useState(true);
const filtered = filter === 'all' ? deployments : deployments.filter(d => d.env === filter);
return (
<div style={{ background: '#0f0f23', minHeight: '100vh', padding: '20px', color: '#e0e0e0', fontFamily: 'system-ui' }}>
<h1 style={{ color: '#64ffda', marginBottom: '8px' }}>Preview Deployments</h1>
<p style={{ color: '#8892b0', marginBottom: '24px' }}>Pipeline: dev -> preview -> staging -> production</p>
{showPipeline && (
<div style={{ display: 'flex', gap: '4px', marginBottom: '24px', alignItems: 'center' }}>
{pipeline.map((step, i) => (
<React.Fragment key={step.name}>
<div style={{
flex: 1, padding: '12px', borderRadius: '8px', textAlign: 'center',
background: '#1a1a2e', border: '1px solid #333',
}}>
<div style={{ color: '#64ffda', fontWeight: 'bold', fontSize: '20px' }}>{step.icon}</div>
<div style={{ color: '#fff', fontSize: '13px', fontWeight: 'bold' }}>{step.name}</div>
<div style={{ color: '#8892b0', fontSize: '11px' }}>{step.desc}</div>
</div>
{i < pipeline.length - 1 && <span style={{ color: '#64ffda', fontSize: '20px' }}>→</span>}
</React.Fragment>
))}
</div>
)}
<div style={{ display: 'flex', gap: '8px', marginBottom: '16px' }}>
{(['all', 'production', 'staging', 'preview'] as const).map(f => (
<button key={f} onClick={() => setFilter(f)} style={{
padding: '6px 12px', borderRadius: '6px', border: 'none', cursor: 'pointer', fontSize: '13px',
background: filter === f ? (f === 'all' ? '#64ffda' : envColors[f]) : '#1a1a2e',
color: filter === f ? '#0f0f23' : '#8892b0', fontWeight: 'bold',
}}>{f === 'all' ? 'Wszystkie' : f.charAt(0).toUpperCase() + f.slice(1)}</button>
))}
<button onClick={() => setShowPipeline(!showPipeline)} style={{
padding: '6px 12px', borderRadius: '6px', border: '1px solid #333', background: 'transparent', color: '#8892b0', cursor: 'pointer', fontSize: '13px', marginLeft: 'auto',
}}>{showPipeline ? 'Ukryj pipeline' : 'Pokaz pipeline'}</button>
</div>
<div style={{ display: 'grid', gap: '8px' }}>
{filtered.map(d => (
<div key={d.id} style={{
padding: '14px', borderRadius: '8px', background: '#1a1a2e',
border: '1px solid ' + envColors[d.env] + '40',
}}>
<div style={{ display: 'flex', alignItems: 'center', gap: '8px', marginBottom: '6px' }}>
<span style={{ width: '8px', height: '8px', borderRadius: '50%', background: statusColors[d.status], flexShrink: 0 }} />
<code style={{ color: '#fff', fontWeight: 'bold', fontSize: '13px' }}>{d.branch}</code>
<span style={{ fontSize: '10px', padding: '2px 8px', borderRadius: '4px', background: envColors[d.env] + '20', color: envColors[d.env] }}>{d.env}</span>
{d.pr && <span style={{ fontSize: '11px', color: '#8892b0' }}>PR #{d.pr}</span>}
<span style={{ fontSize: '11px', color: '#666', marginLeft: 'auto' }}>{d.age}</span>
</div>
<div style={{ display: 'flex', alignItems: 'center', gap: '8px' }}>
<code style={{ color: '#8892b0', fontSize: '12px' }}>{d.url}</code>
<code style={{ color: '#666', fontSize: '11px', marginLeft: 'auto' }}>{d.commit}</code>
</div>
</div>
))}
</div>
</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. Preview Deployments na Vercel są generowane automatycznie:
2. CDN (Content Delivery Network) zapewnia:
To 2 z 11 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Układanie w pionie
Ułóż prawidłową kolejność środowisk w pipeline wdrożeń:
- Układanie w pionie
Ułóż elementy w prawidłowej kolejności: Define experiment → Split traffic → Trac
- Układanie w pionie
Ułóż kroki analizy rozmiaru bundle'a w prawidłowej kolejności:
- Układanie w pionie
Ułóż elementy w prawidłowej kolejności: Audit dependencies → Set CSP headers → E
- Układanie w pionie
Ułóż elementy w prawidłowej kolejności: Code commit do repository → CI/CD pipeli
- Układanie w poziomie
Ułóż eksport konfiguracji ESLint w pliku eslint.config.mjs (po imporcie: import nextVitals from 'eslint-config-next/core-web-vitals')
- Układanie w pionie
Uporządkuj etapy obsługi incydentów produkcyjnych
- Klikanie w kolejności
Ułóż polecenie Docker build:
- Edytor kodu
Utwórz w Markdown checklistę wdrożenia produkcyjnego z pięcioma sekcjami (nagłówkami): bezpieczeństwo, wydajność, monitoring, kopie zapasowe i zgodność z przepisami. W każdej sekcji dodaj co najmniej dwa punkty jako pola wyboru (- [ ] ...).
- Klikanie w kolejności
Ułóż konfigurację Vercel deploy:
Zadania po tej lekcji
- PytanieCzym są Preview Deployments?
- Ułóż w kolejnościPipeline wdrożeń: od kodu do produkcji
- PytanieCDN (Content Delivery Network) zapewnia:
- PytanieLoad balancing służy do:
- Ułóż w kolejnościKolejność: Define experiment → Split traffic → ...
- PytanieBlue-green deployment oznacza:
- PytanieA/B testing pozwala na:
- Ułóż w kolejnościProces analizy bundle'a w Next.js
- PytanieRollback strategy w production powinna:
- PytanieFeature flags pozwalają na:
- Ułóż w kolejnościKolejność: Audit dependencies → Set CSP headers → ...
- PytanieZagnieżdżanie komponentów w App Router
- PytanieMulti-stage build w Dockerfile
- Ułóż w kolejnościKolejność: Code commit do repository → CI/CD pipeline t
- PytanieOptymalizacja wydajności Next.js
- PytanieKonfiguracja ścieżek w tsconfig.json
- Ułóż w kolejnościKonfiguracja ESLint w Next.js
- Ułóż w kolejnościObsługa Incydentów: Proces reakcji
- Kliknij w kolejnościPolecenie Docker build
- Zadanie z kodemPraktyka: checklista wdrożenia produkcyjnego
- Kliknij w kolejnościKonfiguracja Vercel deploy