Deployment Ne Intanɛt So

i18n.site gye kratafa biako application nhyehyɛe tom, na wɔde wɛbsaet no kwan a wɔfa so kɔ mu ne wɛbsaet no mu nsɛm no di dwuma wɔ ahofadi mu.

Sɛ woyɛ atifi hɔ nkyerɛase no wie a, wɔbɛhyehyɛ directory htm ne v wɔ md/out/dev directory no ase.

Ɛha yi, dev kyerɛ sɛ wɔasi no gyina .i18n/htm/dev.yml nhyehyeɛ fael no so.

dev kyerɛwtohɔ :

htm directory no yɛ wɛbsaet no kwan a wɔfa so kɔ mu no.

v directory no kura wɛbsaet no mu nsɛm a version nɔma wom.

Local preview mfa version number no ho na ɛbɛ copy fael nyinaa akɔ out/dev/v/0.1.0 directory no mu.

Sɛ wɔayi no adi wɔ aban kwan so a, wɔbɛkyerɛw fael a wɔasesa no akɔ version nɔma directory foforo no mu.

Kyerɛ Nhyehyeɛ Fael a Ɛwɔ -c

Nsiesiei fael ahorow bɛbɔ daerekta ahorow a ɛne no hyia wɔ out daerekta no mu.

Sɛ nhwɛso no, .i18n/htm/main.yml bɛbɔ out/main daerekta no.

dev.yml ne main.yml yɛ nhyehyeɛ a wɔahyɛ da ayɛ.

dev yɛ development tiawa, a ɛkyerɛ nkɔsoɔ tebea, a wɔde di dwuma ma mpɔtam hɔ nhwɛsoɔ, na ɛsan nso yɛ nhyehyeɛ fael a wɔahyɛ da ayɛ. ol yɛ online tiawa, a ɛkyerɛ intanɛt so tebea, a wɔde di dwuma ma aban kwan so yie Ɛsan nso yɛ default nhyehyeɛ fael berɛ a wode ahyɛdeɛ kwan parameters -n kɔsi npm redi dwuma de ayi no adi.

Wubetumi nso ayɛ nhyehyeɛ fael foforɔ Fa --htm_conf di dwuma wɔ ahyɛdeɛ kwan no so de kyerɛ nhyehyeɛ fael din a wode bedi dwuma:

Nhwɛsoɔ:

i18n.site --htm_conf dist --save

Ɛha na --save gyina hɔ ma update release version nɔma.

Kyerɛw nsɛm a ɛwɔ mu no kɔ npmjs.com

Nsɛm a wobɛtintim akɔ npmjs.com

Login & npm

Install nodejs , fa npm login kɔ mu .

Sesa md/.i18n/htm/main.yml na sesa md: boɔ YOUR_NPM_PACKAGE sɛ w'ankasa npm paket din biara a obiara nni mu wɔ npmjs.com

Afei sesa md/.i18n/htm/main.package.json

Tu mmirika i18n.site --npm anaa i18n.site -n wɔ md directory no mu na kyerɛ ase na tintim.

Sɛ wode continuous integration environment di dwuma de tintim a, ɛho nhia sɛ wobɛ instɔl nodejs Kɔpi logged-in ne publishing permissions ~/.npmrc no kɔ environment no mu kɛkɛ.

Sɛ wo sesa package din a ɛyɛ v: wɔ main.yml mu a, yɛsrɛ wo hwɛ hu sɛ wubedi kan apopa .i18n/v/main na afei woatintim.

Proxy Server a npm Tintimii

Sɛ wɔn a wɔde di dwuma wɔ China asasepɔn so no hyia ntwamutam haw na wɔantumi antintim npm packages a, wobetumi de environment variable https_proxy asiesie proxy server no.

Sɛ yɛfa no sɛ wo proxy server port no yɛ 7890 , wobɛtumi akyerɛw:

https_proxy=http://127.0.0.1:7890 i18n.site -n

Nsɛm a Wɔde Wɔn Ankasa Ahyɛ Mu

Sɛ wopɛ sɛ wo ho gye nsɛm no a, di kan sesa md/.i18n/htm/main.yml na sesa v: //unpkg.com/i18n.site kɔ wo URL anim, te sɛ v: //i18n-v.xxx.com .

Hyehyɛ md directory no mu na tu mmirika

i18n.site --htm_conf ol --save

anaasɛ asɛmfua tiawa

i18n.site -c ol -s

Afei, hyehyɛ nsɛm a ɛwɔ md/out/main/v daerekta no mu no kɔ URL prefix kwan a wɔahyehyɛ wɔ v: mu no so.

Awiei koraa no, hyehyɛ cache bere a ɔkwan a ɛba awiei wɔ /.v kosi 1s , anyɛ saa a wontumi nkɔ nsɛm a wɔayi no adi foforo no so ntɛm ara.

Wobetumi de cache bere ama akwan afoforo no ayɛ afe biako anaa nea ɛboro saa de atew abisade a ɛho nhia so.

Host Nsɛm a Ɛwɔ Mu No Kɔ s3

Sɛ wopɛ sɛ wo host content CDN , ɛka w’ankasa server a wode bedi dwuma ho no, ɔkwan foforo a wɔtaa fa so yɛ ne sɛ wode S3 bedi dwuma +

S3 S3 rclone

i18n.site -c ol -s
s3=your-s3
bucket=your-bucket
ver=$(head -1 .i18n/v/main/v.hash | cut -c 2-)
rclone copy --overwrite-dir out/main/htm/v/$ver $s3:/$bucket/$ver
rclone copy out/main/v/.v "$s3:/$bucket/"

Kae sɛ wobɛhyehyɛ CDN sɛnea ɛbɛyɛ a ɔkwan a ɛba awiei wɔ /.v no cache bere no bɛyɛ 1s , anyɛ saa a wontumi nkɔ nsɛm a wɔayi no adi foforo no so ntɛm ara.

Tintim Wɛbsaet Hɔ

Wobetumi de wɛbsaet no akɔ baabiara github page na cloudflare page yɛ akwan pa.

Esiane sɛ wɛbsaet no de kratafa biako application architecture di dwuma nti, kae sɛ wobɛsan akyerɛw URL akwan a enni . kosi index.html .

Ɛho hia sɛ wɔde wɛbsaet no mu krataafa no di dwuma pɛnkoro pɛ, na ɛho nhia sɛ wɔsan de wɛbsaet no mu krataafa no si hɔ ma nsɛm foforo a edi hɔ.

Deploy Wɔ github Krataafa No So

Di kan github ha na yɛ ahyehyɛde bi i18n-demo

Afei yɛ warehouse i18n-demo.github.io wɔ saa ahyehyɛdeɛ yi ase (yɛsrɛ wo fa ahyehyɛdeɛ din a woabɔ no si i18n-demo ananmu):

Sɛ woretintim nsɛm a ɛwɔ asɛm a atwam no mu a, wɔayɛ out/main/htm Yɛsrɛ wo hyɛ saa nkyerɛwde yi mu na tu mmirika :

ln -s index.html 404.html

Esiane sɛ github page ntumi mmoa URL kwan a wɔsan kyerɛw nti, wɔde 404.html di dwuma mmom.

Afei fa ahyɛde a edidi so yi kɔ htm directory no mu (kae sɛ wode w’ankasa warehouse address besi i18n-demo/i18n-demo.github.io.git ananmu) :

git init
git branch -M main
git remote add origin [email protected]:i18n-demo/i18n-demo.github.io.git
git push -u origin main -f

Sɛ wopia koodu no wie a, twɛn ma deployment github page no nkɔ yiye (sɛnea wɔakyerɛ wɔ ase ha no) ansa na woatumi akɔ mu.

Sɛ wopɛ demo krataafa a, yɛsrɛ wo hwɛ:

https://i18n-demo.github.io

Deploy Wɔ cloudflare Krataafa So

cloudflare page github page

cloudflare page a wɔde di dwuma no taa gyina github page a wɔde di dwuma wɔ atifi hɔ no so.

Yɛ project na kyekyere i18n-demo.github.io warehouse a ɛwɔ atifi hɔ no.

Wɔakyerɛ ɔkwan a wɔfa so yɛ no wɔ mfonini a ɛwɔ ase ha no mu:

Yɛsrɛ wo klik Add Account so na ma kwan ma ahyehyɛde i18n-demo no nkɔ .

Sɛ woakyekyere ahyehyɛde foforo adekoradan a, ebia ɛho behia sɛ wobɔ Add Account mprenu na ama wo tumi mprenu ansa na wɔada ahyehyɛde foforo no adi.

Afei, paw warehouse i18n-demo.github.io , afei klik Begin setup , na fa default values no di dwuma ma anammɔn a edi hɔ no.

Sɛ wokyekyere nea edi kan wie a, ɛsɛ sɛ wotwɛn simma kakraa bi ansa na woatumi akɔ mu.

Sɛ wode di dwuma wie a, wubetumi akyekyere domain din a wɔahyɛ da ayɛ.

Sɛ wokyekyere domain din a wɔahyɛ da ayɛ no wie a, yɛsrɛ wo kɔ domain din no so na hyehyɛ ɔkwan a wɔbɛsan akyerɛw wɔ kratafa biako application no so, sɛnea wɔakyerɛ wɔ ase ha no:

Mmara a ɛwɔ atifi hɔ mfonini no mu no te i18n.site nea edidi so yi.

(http.host in {"i18n.site"}) and not (
substring(http.request.uri.path,-3) in {".js" ".gz"} or
substring(http.request.uri.path,-4) in {".htm" ".rss" ".css" ".svg" ".ico" ".png" ".xml" ".txt"} or
substring(http.request.uri.path,-5) in {".html" ".avif" ".json"} or
ends_with(http.request.uri.path,".webmanifest")
)

Bio nso, yɛsrɛ wo hyehyɛ cache mmara no, sɛnea wɔakyerɛ wɔ ase ha no, na fa cache bere tenten no si ɔsram biako.

Yɛsrɛ wo sesa domain din a ɛne no hyia wɔ anammɔn a ɛtɔ so mmienu wɔ mfonini a ɛwɔ atifi hɔ no mu kɔ domain din a woakyekyere no so.

Wɛbsaet a Wɔde Bedi Dwuma Yiye Wɔ China Asasepɔn So

Sɛ wopɛ sɛ wunya accessibility adwumayɛ a eye wɔ network tebea a ɛwɔ China asasepɔn no so a, yɛsrɛ wo di kan kyerɛw domain din .

Afei, fa nneɛma a wɔkora so a cloud vendors wɔ + asasepɔn so no di dwuma CDN Deploy the following content out/main/htm .

Wubetumi de edge computing adi dwuma de asan akyerɛw ɔkwan no de ayɛ nsakrae wɔ kratafa biako application ahorow mu Sɛ nhwɛso no, wobetumi asiesie Baidu Smart Cloud CDN te sɛ eyi:

const uri = r.uri, p = uri.lastIndexOf(".");
if (
  p < 0 ||
  !"|js|css|htm|html|md|avif|json|ico|xml|rss|gz|mp4|png|svg|txt|webmanifest|".includes(
    "|" + uri.slice(p + 1) + "|",
  )
) {
  const ua = r.headersIn["User-Agent"].toLowerCase()
  if (/facebookexternalhit|slurp|bot|spider|curl/.test(ua)) {
    r.return(
      302,
      (/baidu|yisou|sogou|360|byte/.test(ua) ? "/zh" : "/en") + r.uri + ".htm",
    )
  } else {
    r.uri = "/index.html"
  }
}

r.respHeader(() => {
  const t = [], out = r.headersOut;
  ["Content-MD5", "Age", "Expires", "Last-Modified"].forEach(
    i => delete out[i]
  )
  r.rawHeadersOut.forEach(i => {
    const key = i[0].toLowerCase()
    if (key.startsWith("x-") || key.startsWith("ohc-")) {
      delete out[key]
    }
  })
  out["Cache-Control"] = "max-age=" + 9e5
  // Wobetumi de mmuae atiri no asi hɔ sɛ ɛnyɛ debug output, te sɛ out.XXX = 'MSG';
})

Esiane sɛ record MX ne record CNAME ntumi ntra faako nti, sɛ wopɛ sɛ wo nsa ka domain name emails bere koro mu a, ɛsɛ sɛ wo ne cname_flatten script no yɛ biako kɔ level CNAME kɔ record A mu.

Afei nso, esiane sɛ amannɔne kar akwan ho ka a mununkum tɔnfo wɔ China asasepɔn so Cloudflare for SaaS bo yɛ den nti, sɛ wopɛ sɛ wobɔ ka yiye a, wubetumi de Huawei Cloud DNS kar akwan a wɔdannan──Traffic routing wɔ China asasepɔn so Baidu Cloud CDN , amanaman ntam kar akwan kɔ cloudflare .

Saa deployment optimization solutions yi yɛ den kɛseɛ na wɔde bɛba wɔ ti ahodoɔ mu daakye.

Generic Domain Din a Wɔde Kɔ Baabi Foforo

Sɛ wode i18n.site di dwuma de yɛ wɛbsaet sɛ wo wɛbsaet titiriw a, mpɛn pii no ɛsɛ sɛ wo hyehyɛ pan-domain redirection, kyerɛ sɛ, wobɛdan akɔ *.xxx.com (a www.xxx.com ka ho) akɔ xxx.com .

Wobetumi de Alibaba Cloud CDN EdgeScript ( Engiresi krataa / Chinafo krataa ) mmoa adi saa ahwehwɛde yi ho dwuma .

Fa domain din no ka ho wɔ CDN Cloud mu na twe adwene si domain din *.xxx.com kɔ CNAME wɔ Alibaba Cloud CDN mu .

Sɛ nhwɛso no, pan-domain din redirection nhyehyɛe a ɛyɛ *.i18n.site wɔ mfonini a ɛwɔ atifi hɔ no mu no te sɛ nea edidi so yi:

rewrite(concat('https://i18n.site',$uri), 'redirect',301)

Fa nginx Di Dwuma

Yɛsrɛ wo fa nhyehyeɛ a ɛte sɛ deɛ ɛdidi soɔ /root/i18n/md/out/main/htm wɔ server out/main/htm a ɛwɔ nginx

location / {
  root  /root/i18n/md/out/main/htm;
  add_header Cache-Control "max-age=9999999";
  if ($uri !~* \.(avif|css|html|ico|js|json|png|svg|txt|webmanifest|xml)$) {
     rewrite ^ /index.html last;
  }
}

Egyina github action a Ɛkɔ So Ka Bom So

Wubetumi ahwɛ nea edidi so yi mu de asiesie wo github action :

name: i18n.site

on:
  workflow_dispatch:
  push:
    branches:
      - main
      - dist

jobs:
  i18n:

    permissions:
      repository-projects: write
      contents: write

    runs-on: ubuntu-latest

    steps:
      - name: checkout
        uses: actions/checkout@v4

      - name: https://i18n.site
        uses: i18n-site/github-action-i18n.site@main
        with:
          I18N_SITE_TOKEN: ${{ secrets.I18N_SITE_TOKEN }}
          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

Sɛnea yebetumi ahu wɔ nhyehyɛe no mu no, wɔhyɛ saa adwumayɛ nhyehyɛe yi bere a wɔrepia akɔ nkorabata main ne baa dwumadibea dist no.

Adwuma nhyehyɛe no de nhyehyeɛ fael a ɛne baa dwumadibea din hyia no bedi dwuma de atintim krataa no Ɛha yi, wɔde .i18n/htm/main.yml ne .i18n/htm/dist.yml bedi dwuma sɛ nhyehyɛɛ a wɔde tintim nhoma no.

Yɛkamfo nneyɛe pa a edidi so yi kyerɛ wɔ nkrataa a wɔayi no adi ho nhyehyɛe no ho:

Sɛ wɔpia nsakraeɛ kɔ branch main a, wɔhyɛ krataa no sɛ wɔnsi na wɔmfa nkɔ preview station no so (preview station no wɔ hɔ github page ).

Sɛ wosi so dua sɛ krataa no teɛ wɔ preview site no so wie a, wɔbɛka code no abom na wɔapia akɔ branch dist , na official build ne deployment no bɛkɔ intanɛt so.

Nokwarem no, atifi hɔ nhyehyɛe no a wɔde bedi dwuma no hwehwɛ sɛ wɔkyerɛw nhyehyɛe pii.

Wubetumi ahwɛ adwuma no github.com/fcdoc/doc so ama adwumayɛ nhyehyɛe scripting.

secrets.I18N_SITE_TOKEN ne secrets.NPM_TOKEN wɔ nhyehyeɛ no mu hwehwɛ sɛ wo hyehyɛ kokoam nsakraeɛ wɔ koodu nnyinasoɔ no mu.

I18N_SITE_TOKEN i18n.site/token

NPM_TOKEN yɛ tintim token a ɛwɔ package npm mu wɔ Visit npmjs.com na yɛ token a ɛwɔ tintim ho kwan (sɛnea wɔakyerɛ wɔ aseɛ ha yi).

Directory Nhyehyɛe

public

Fael ahorow a ɛwɔ wɛbsaet no so, te sɛ favicon.ico , robots.txt , ne nea ɛkeka ho.

Wobetumi de realfavicongenerator.net

.i18n

Wɔ .i18n directory no ase no, nhyehyeɛ fael, nkyerɛaseɛ cache, ne nea ɛkeka ho a ɛwɔ i18n.site Hwɛ ti a ɛdi hɔ "Nsiesiei" ma nsɛm no mu nsɛm.

en

Source kasa directory, a ɛne en of fromTo wɔ .i18n/conf.yml nhyehyɛe fael hyia

i18n:
  fromTo:
    en: zh

Yɛsrɛ wo hwɛ nkyerɛase nhyehyɛe no i18