Jinsi ya Kutumia Vercel: Mwongozo wa Haraka Kuanzia Uwekaji wa Kwanza Hadi Uzalishaji
Ikiwa umewahi kutamani kuweka programu ya wavuti iwe rahisi kama kuhifadhi faili kuliko kusafirisha msimbo, basi habari njema ni hii: Hivyo ndivyo hasa inavyohisi inapoanza kufanya kazi. Katika dakika chache, unaweza kwenda kutoka kwenye uendelezaji wa ndani hadi programu ya kimataifa, iliyoimarishwa na makali yenye hakikisho kwa kila ombi la kuvuta na bila ya kusimamia. Mwongozo huu wa kivitendo, unaolenga suluhisho unakuelekeza hatua kwa hatua jinsi ya kutumia —ukishughulikia usanidi, mifumo kama vile , vibadala vya mazingira, vitendaji visivyo na seva, , vikoa, hifadhi, uwezo wa kuona, na mbinu bora za uzalishaji.
Tutaenda haraka, lakini utapata ulinzi, orodha hakiki, na mifano unayoweza kunakili na kubandika. Iwe unaweka ukurasa wa kutua, , au hifadhi mbalimbali, utajifunza mambo muhimu ya kusafirisha kwa ujasiri.
ni Nini na Kwa Nini Uitume?
ni jukwaa la kuendeleza, kuhakiki, na kusafirisha programu za wavuti. Imeboreshwa kwa mifumo ya kisasa (hasa ), ikitoa:
- Uwekaji wa papo hapo: Kila
msukumo wa git huunda URL ya kipekee ya hakikisho.
- Utendaji wa kimataifa: Rasilimali tuli, , na akiba kwenye makali.
- Vitendaji visivyo na seva: Njia za bila kutoa seva.
- Hakikisho lisilo na CI: Ujenzi wa kiotomatiki + hakikisho kwa kila .
- Usaidizi wa daraja la kwanza wa <b>Next.js</b>: Uboreshaji wa Picha, , (Uzalishaji Tuli wa Hatua kwa Hatua).
Ikiwa lengo lako ni kasi, , na uaminifu na gharama ndogo ya uendeshaji, kujifunza jinsi ya kutumia hulipa haraka.
Usanidi: Jinsi ya Kutumia katika Dakika 10
- Fungua akaunti katika
vercel.com na unganishe GitHub/GitLab/Bitbucket.
- Ingiza hifadhi yako (mfano, , , , , , ). hugundua kiotomatiki mfumo na mipangilio ya ujenzi.
- Bofya Weka → hujenga na kukupa URL ya kipekee ya hakikisho.
- Weka vibadala vya mazingira chini ya .
- Pandisha hadi uzalishaji kwa kuweka Tawi la Uzalishaji (kawaida
kuu) na kuunganisha yako.
- Ongeza kikoa maalum chini ya na uelekeze .
- Fuatilia ujenzi, kumbukumbu, na utendaji kupitia dashibodi.
Umejifunza njia fupi zaidi ya jinsi ya kutumia . Sasa hebu tuingie ndani zaidi.
Kuanza: Kutoka Ndani hadi Uwekaji wa Kwanza
1) Unda au ingiza mradi
npx create-next-app@latest my-app
cd my-app
npm run dev
git init
git add -A
git commit -m "init"
git branch -M main
git remote add origin {your-repo-url}
git push -u origin main
- Katika : Mradi Mpya → Ingiza Hifadhi ya → Weka.
hugundua kiotomatiki mfumo (mfano, ) na kuweka chaguo-msingi kama vile npm install, npm run build, na saraka za pato.
2) Elewa mazingira
- Uendelezaji: Mashine ya ndani (
npm run dev).
- Hakikisho: Kila au msukumo wa tawi huweka kwenye URL ya kipekee kama `
- Uzalishaji: Tawi kuu (linaweza kusanidiwa) → `
Huu ndio msingi wa jinsi ya kutumia kwa ufanisi: chukulia kila kama kiungo kinachoweza kushirikiwa cha majaribio.
Dhana Muhimu Utakazotumia Hasa
Vibadala vya mazingira
- Ongeza vibadala vya Uendelezaji, Hakikisho, Uzalishaji kando.
- Katika , funua vibadala salama kwa mteja na kiambishi awali cha
NEXT_PUBLIC_.
Mfano:
NEXT_PUBLIC_API_BASE=
DATABASE_URL=postgres://...
JWT_SECRET=supersecret
Tumia katika msimbo:
const api = process.env.NEXT_PUBLIC_API_BASE
const conn = process.env.DATABASE_URL
Vitendaji Visivyo na Seva (Njia za )
- Katika , unda
pages/api/hello.ts au app/api/hello/route.ts.
// app/api/hello/route.ts
import { NextResponse } from 'next/server'
export async function GET {
return NextResponse.json({ message: 'Hello from Vercel Functions!' })
}
- Hizi huwekwa kama vitendaji visivyo na seva na uanzishaji baridi umepunguzwa na kumbukumbu zinaonekana kwenye dashibodi ya .
- Tumia kwa ukaguzi wa uthibitishaji, majaribio ya A/B, ujanibishaji, uandishi upya, au sheria za roboti/ngome kwenye makali.
import { NextResponse } from 'next/server'
import type { NextRequest } from 'next/server'
export function middleware(req: NextRequest) {
const country = req.geo?.country || 'US'
const res = NextResponse.next
res.headers.set('x-country', country)
return res
}
Uboreshaji wa Picha na Rasilimali Tuli
-
next/image hutumia kiotomatiki Uboreshaji wa Picha wa .
- Weka faili tuli katika
public/. huzihudumia na kuzihifadhi kwenye makali.
(Uzalishaji Tuli wa Hatua kwa Hatua)
- Jenga upya tu kurasa zinazobadilika—hakuna haja ya kuweka tena kamili.
export const revalidate = 60 // seconds
Weka Utaratibu wa Uwekaji Unaokua
Hakikisho la tawi kama utaratibu wa kazi wa bidhaa
- Sukuma kwa tawi la kipengele → shiriki URL ya hakikisho na /muundo.
- Kusanya maoni katika muktadha. Hakuna picha za skrini, kipengele cha moja kwa moja tu.
- Unganisha inapoidhinishwa; hupandisha hadi uzalishaji kiotomatiki ikiwa
main imewekwa kama Uzalishaji.
Hifadhi Mbalimbali
- inasaidia hifadhi mbalimbali; weka mzizi wa mradi wakati wa kuingiza.
- Tumia
vercel.json kusanidi ujenzi na kupuuzwa:
{
"buildCommand": "pnpm -w build",
"ignoreCommand": "git diff --quiet HEAD^ HEAD ./apps/web",
"framework": "nextjs"
}
Mipangilio maalum ya ujenzi
- Batilisha amri za ujenzi katika .
- Weka
Saraka ya Pato ikiwa unatumia mifumo kama (dist) au .
Jinsi ya Kutumia na (Sehemu Bora)
ndio mfumo wa marejeleo wa , kwa hivyo utapata bora zaidi hapa.
- Vipengele vya kama vile
Route Handlers, Server Actions, dynamic = 'force-dynamic', na maagizo ya akiba yanaelekezwa moja kwa moja kwenye miundombinu ya .
- Mfano wa njia ya na akiba:
// app/api/products/route.ts
import { NextResponse } from 'next/server'
export async function GET {
const data = await fetch(' { next: { revalidate: 3600 } })
return NextResponse.json(await data.json)
}
- Mfano wa udhibiti wa utoaji wenye nguvu:
export const dynamic = 'force-dynamic' // opt out of static rendering
- Muda wa utekelezaji wa makali:
export const runtime = 'edge'
Hizi ni levers za vitendo katika jinsi ya kutumia kusawazisha kasi, upya, na gharama.
Vikoa, , na Uelekezaji Upya
- Ongeza kikoa chini ya . hutoa kiotomatiki.
- Kwa , elekeza (au inapohitajika) kwa lengo la .
- Uelekezaji upya na uandishi upya kupitia
next.config.js au vercel.json:
// next.config.js
module.exports = {
async redirects {
<a4>return hukuruhusu kuzungumza na kwenye ukurasa wowote—ni muhimu kwa kutoa vipande vya usanidi, kufanya muhtasari wa hakikisho la , au kuandaa orodha hakiki za baada ya kuweka moja kwa moja kutoka kwenye dashibodi ya .