この記事では、トランクベースの開発と環(huán)境ベースの機(jī)能フラグを中心に構(gòu)築された、Web アプリケーションの堅(jiān)牢かつ効率的なリリース プロセスについて概説します。この方法論により、高品質(zhì)の標(biāo)準(zhǔn)を維持しながら、継続的な統(tǒng)合、運(yùn)用環(huán)境での簡単なテスト、開発からリリースまでのスムーズなパスが保証されます。

---

基本原則

1. トランクベースの開発:

   • trunk ブランチは、すべての開発作業(yè)の 唯一の信頼できる情報(bào)源 として機(jī)能します。
   • 開発者は、新機(jī)能または Jira チケットのトランクから機(jī)能ブランチ (feature/xyz など) を作成します。
   • プル リクエスト (PR) は、テストが成功した後のレビューとマージのために、これらの機(jī)能ブランチからトランクに送信されます。

2. 環(huán)境ベースの機(jī)能フラグ:

   • 機(jī)能フラグは、環(huán)境全體での機(jī)能のアクティブ化を制御するために使用されます。
   • フラグは、環(huán)境固有の構(gòu)成ファイル、または CI/CD パイプライン構(gòu)成の一部として保存されます。
   • トランク ブランチでは、すべての機(jī)能フラグはデフォルトで OFF に設(shè)定されています。
   • 必要に応じて、特定の環(huán)境 (サンドボックス、ステージング、運(yùn)用環(huán)境など) でフラグを オン に切り替えることができます。

---

Sprint の JIRA バージョン

---

環(huán)境導(dǎo)入の流れ

1. サンドボックスまたはステージング環(huán)境:

   • QA と統(tǒng)合テストの場合、チームはトランクから Sandbox/ というプレフィックスが付いたブランチ (例: Sandbox/xyz) を作成できます。
   • このブランチは、CI/CD パイプラインを使用して専用の サンドボックス または ステージング環(huán)境 にデプロイされます。
   • QA チームは新機(jī)能を検証でき、統(tǒng)合テストは互換性を確認(rèn)できます。
   • この環(huán)境では、特定の機(jī)能をテストするために機(jī)能フラグが オン に切り替えられます。

2. 本番リリースの準(zhǔn)備:

   • リリースの準(zhǔn)備をするには、トランクから release/xyz ブランチを作成します。
   • release/xyz ブランチはリリース候補(bǔ)として機(jī)能し、最初はベータ テストのために 運(yùn)用トラフィックの 5% にデプロイされます。
   • 実稼働環(huán)境でのテストを可能にするために、このブランチでは新機(jī)能の機(jī)能フラグが オン に切り替えられます。
   • Nginx または同様のロード バランサーは、このトラフィック分割を処理して、ユーザーのサブセットのみが変更を確認(rèn)できるようにすることができます。

---

機(jī)能フラグ: 例と使用法

1. フラグ構(gòu)造:

   • 機(jī)能フラグを構(gòu)成ファイルに保存します (例: config/feature-flags.json)。

    {
      "feature_xyz": false,
      "feature_abc": true
    }
   

• 実行時(shí)に環(huán)境変數(shù)を使用してフラグを制御します:
  

   FEATURE_XYZ=true FEATURE_ABC=false npm start
  

1. バックエンドの例:

   • コード內(nèi)のフラグを切り替えます:

    const featureFlags = require('./config/feature-flags');
   
    if (featureFlags.feature_xyz) {
        console.log('Feature XYZ is enabled!');
    } else {
        console.log('Feature XYZ is disabled.');
    }
   

2. フロントエンドの例:

   • フラグを使用して條件付きで UI コンポーネントをレンダリングします。

    if (process.env.REACT_APP_FEATURE_XYZ === 'true') {
        render(<NewFeatureComponent />);
    } else {
        render(<OldFeatureComponent />);
    }
   

3. テスト中のフラグの切り替え:

   • テスト用のフラグを切り替えるには、構(gòu)成変數(shù)または環(huán)境変數(shù)を更新し、関連するサービス (フロントエンドまたはバックエンド) を再起動(dòng)します。

    FEATURE_XYZ=true npm start
   

• CI/CD パイプラインの場合は、デプロイ中に適切なフラグ値が環(huán)境に挿入されていることを確認(rèn)してください。

---

本番環(huán)境でのテスト

1. ベータ テストのトラフィック ルーティング:

   • Nginx 構(gòu)成を使用してトラフィック割り當(dāng)てを制御します。

    http {
        upstream stable_backend {
            server stable_backend_1;
            server stable_backend_2;
        }
   
        upstream canary_backend {
            server canary_backend_1;
            server canary_backend_2;
        }
   
        upstream mixed_backend {
            server stable_backend_1 weight=45;
            server stable_backend_2 weight=45;
            server canary_backend_1 weight=5;
            server canary_backend_2 weight=5;
        }
   
        server {
            listen 80;
            server_name my-app.example.com;
   
            location / {
                if ($http_x_qa_test = "true") {
                    proxy_pass http://canary_backend;
                    break;
                }
   
                proxy_pass http://mixed_backend;
            }
        }
    }
   

• ロード バランサーの重みを調(diào)整して、運(yùn)用トラフィックの 5% を新しいバージョンを?qū)g行しているサーバーにルーティングします。

1. 本番環(huán)境での専用の QA テスト:
   • QA チームは、リクエストにカスタム Cookie (例: qa-test=true) を添付できます。
   • Nginx はこの Cookie をチェックし、これらのリクエストを 100% の確率で新しいバージョンにルーティングし、実稼働環(huán)境での対象を絞ったテストを保証します。

---

リリースの安定化

1. 問題の修正:

   • 開発者は、PR をトランク ブランチに開くことで、ベータ テスト中に特定された問題を修正します。
   • マージされると、これらの修正は厳選して release/xyz ブランチに追加されます。

2. リリースを完了中:

   • すべての問題が解決され、ブランチが安定すると、リリース ブランチに セマンティック バージョン (例: v1.2.0) のタグが付けられ、安定したバックエンドへのデプロイがトリガーされます。
   • リリースノートはドキュメント用に生成され、関係者と共有されます。

---

ホットフィックスプロセス

1. ホットフィックス ブランチの作成:

   • 緊急の修正の場合は、最新の実稼働タグから直接 hotfix/xyz ブランチを作成します。
   • ホットフィックス ブランチは、リリース ブランチと同じ安定化およびタグ付けプロセスに従います。

2. バージョン管理:

   • ホットフィックスは、セマンティック バージョニング (SemVer) 標(biāo)準(zhǔn)に従って、パッチ バージョン を増加させます (例: v1.2.0 から v1.2.1)。

---

ブランチのクリーンアップ

• 混亂を避けるために、マージされたブランチを定期的に削除します。
• 組織を維持するために、未使用の機(jī)能フラグを定期的に削除します。
• GitHub Actions または同様のツールを使用して、マージ後のブランチ削除を自動(dòng)化します。

---

代替の QA およびテスト戦略

本番環(huán)境で QA トラフィックをルーティングするための追加の戦略には、Cookie の代わりに次のようなものがあります。

1. ヘッダーベースのルーティング:

   • QA はカスタム ヘッダー (例: X-QA-Test: true) をリクエストに追加します。
   • Nginx は、テストのためにこれらのリクエストを新しいバージョンにルーティングします。

2. IP ベースのルーティング:

   • QA の IP アドレスに基づいて新しいバージョンへのトラフィックを制限します。

3. 認(rèn)証トークンベースのルーティング:

   • QA は、リクエストが新しいバージョンにルーティングされることを保証するロールまたはトークンに関連付けられた特定のテスト アカウントを使用してログインします。

---

結(jié)論

このリリース プロセスでは、トランク ベースの開発と環(huán)境ベースの機(jī)能フラグを利用して、スケーラブルでテスト可能、本番環(huán)境でも安全な展開ワークフローを作成します。サンドボックス環(huán)境、トラフィック ルーティング、専用のテスト戦略を使用することで、チームはリスクを最小限に抑えながら高品質(zhì)の機(jī)能を提供できます。このアプローチにより、問題を早期に発見して効率的に対処できるようになり、シームレスな機(jī)能のロールアウトとホットフィックスへの道が開かれます。

以上がWeb アプリケーションのリリース プロセスの合理化: 機(jī)能フラグを使用したトランクベースの開発の詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國語 Web サイトの他の関連記事を參照してください。