OpenResty を使用して Beego に高性能 API ゲートウェイを実装する

王林

リリース： 2023-06-23 09:20:53

オリジナル

864 人が閲覧しました

Beego は Web アプリケーションフレームワークとして、Go 言語界ではすでに一定の評判を獲得しています。豊富な HTTP ルーティング、ロギング、ORM などの機能を提供し、Web アプリケーションの開発を容易にします。では、高パフォーマンスの API ゲートウェイを実装したい場合、Beego を使用して実現できるでしょうか?答えは「はい」です。この記事では、OpenRestyを使用してBeegoに高パフォーマンスなAPIゲートウェイを実装する方法を紹介します。

API ゲートウェイとは何ですか?

API ゲートウェイは、サービスポートとクライアントの間に位置する中間層で、複数のバックエンドサービスを接続し、外部にシンプルな API インターフェイスを提供するために使用されます。マイクロサービスアーキテクチャでは、多数のサービスと一貫性のないサービスプロトコルのため、さまざまなサービスを転送および変換するために API ゲートウェイが必要になることがよくあります。

API ゲートウェイを実装するときは、次の 3 つの側面を考慮する必要があります。

複数のプロトコルのサポート。バックエンドサービスは、HTTP、WebSocket、gRPC などのさまざまなプロトコルを使用する場合があります。API ゲートウェイはこれらのプロトコルをサポートし、統一された API インターフェイスに変換できる必要があります。
負荷分散とフォールトトレランス。 API ゲートウェイは、バックエンドサービスの高可用性と高パフォーマンスを確保するために、ロードバランシングとフォールトトレランスのメカニズムを実装する必要があります。
安全上の考慮事項。 API ゲートウェイは、バックエンドサービスの信頼性とセキュリティを確保するために、認可、認証、アクセス制御などのセキュリティ機能を提供する必要があります。

OpenResty の紹介

OpenResty は、中国人プログラマー Zhang Ychun によって開発された、Nginx ベースの Web アプリケーションサーバーです。 Nginx を拡張して Lua スクリプト言語をサポートし、高パフォーマンスの動的な拡張を可能にします。 OpenRestyは高いパフォーマンスが特徴で、静的リソースをメモリにキャッシュし、コルーチンなどの技術を利用することで、高い同時実行性と低遅延を実現しています。

この記事では、API ゲートウェイのコアコンポーネントとして OpenResty を使用し、バックエンドサービスを管理するためのルーティングと制御ロジックの実装に Beego を使用します。これには 2 つの利点があります: 1 つは、OpenResty の高性能機能を最大限に活用して、API ゲートウェイの応答速度と同時実行性を向上させることができること、2 つ目は、Beego を使用してバックエンドサービスのルーティングと構成を管理できること、開発の複雑さを軽減し、Beego 独自のルーティングおよびコントローラー機能を利用することもできます。

OpenResty を使用して Beego に API ゲートウェイを実装する

OpenResty をインストールする

OpenResty の使用を開始する前に、OpenResty とその関連ソフトウェアパッケージをインストールする必要があります。 OpenResty は、さまざまなプラットフォーム向けに多くのバイナリインストールパッケージを公式に提供しており、公式 Web サイトからダウンロードしてインストールできます。 Ubuntu/Debian を使用している場合は、次のコマンドを使用してインストールできます:

$ sudo apt-get install libreadline-dev libncurses5-dev libpcre3-dev libssl-dev perl make build-essential
$ wget https://openresty.org/download/openresty-1.19.3.2.tar.gz
$ tar -xzvf openresty-1.19.3.2.tar.gz
$ cd openresty-1.19.3.2
$ ./configure --with-http_realip_module --with-http_stub_status_module --with-luajit --prefix=/usr/local/openresty
$ make && sudo make install

ログイン後にコピー

インストールが完了したら、OpenResty のバイナリファイルパスをシステムの PATH 環境変数に追加する必要があります。コマンドラインでインストールできます。nginx などの OpenResty コンポーネントを直接使用します。

$ export PATH=$PATH:/usr/local/openresty/nginx/sbin

ログイン後にコピー

OpenResty ルーティングの実装

Beego で OpenResty を使用するには、OpenResty ルーティングと Beego ルーティングを統合する必要があります。具体的には、Beego のルーティング設定はすべて OpenResty によって処理され、Beego はルーティングに対応するコントローラーを提供するだけで済みます。このプロセスでは、OpenResty の Lua スクリプトを使用してルート配布を実装する必要があります。

次は、単純な OpenResty ルーティングの実装です:

location /api/ {
    content_by_lua_block {
        local args = ngx.req.get_uri_args()
        if args['service'] == 'user' then
            ngx.exec('/user' .. ngx.var.request_uri)
        elseif args['service'] == 'order' then
            ngx.exec('/order' .. ngx.var.request_uri)
        else
            ngx.say('Unknown service')
            ngx.exit(400)
        end
    }
}

ログイン後にコピー

上記のコードでは、場所の構成を通じて、URL プレフィックス /api/ を持つルートを指定します。リクエストを特定のサービスに転送します。特定の転送ルールはリクエストの service パラメータに依存し、異なるパラメータ値に基づいて異なるサービスを選択して、ルート分散を実現できます。

OpenResty が上記と同様の Lua スクリプトを実行するには、これらのスクリプトファイルを指定されたディレクトリに保存し、nginx.conf で Lua スクリプトのパスを設定する必要があります:

lua_package_path "/etc/nginx/conf.d/lua/?.lua;;";

ログイン後にコピー

必須のメモ実際のサービスの転送には ngx.exec を使用するため、OpenResty が正しく照合して転送できるように、対応するサービスコードでより具体的なルートを指定する必要があります。たとえば、次に示すように、特定のルーティングプレフィックスとして /user と /order を指定し、ルーティング設定で ngx.exec を使用して転送できます。 :

location /user/ {
    content_by_lua_block {
        ngx.exec('@user_service')
    }
}

location /order/ {
    content_by_lua_block {
        ngx.exec('@order_service')
    }
}

ログイン後にコピー

ここで、@user_service と @order_service は両方とも、特定のサービスの Nginx の場所を指します。それらの定義は次のようになります:

location @user_service {
    proxy_pass http://127.0.0.1:8080;
    # ...
}

location @order_service {
    proxy_pass http://127.0.0.1:8081;
    # ...
}

ログイン後にコピー

このようにして、シンプルなルーティングと転送を実現しました。ただし、これは OpenResty の機能のほんの一部であり、キャッシュ、リバースプロキシ、電流制限など、多くの強力な機能や機能も備えています。実際の API ゲートウェイ開発では、特定のニーズに応じて適切な機能を選択して使用できます。

Beego コントローラーの実装

OpenResty ルーティングに加えて、Beego にコントローラーとビジネスロジックも実装する必要があります。ここでは、コントローラー内の Beego の組み込み http.ServeFile 関数を使用して、指定された Lua スクリプトをロードすることで、Lua スクリプトの動的ロードを実現できます。

以下は簡単なコントローラーの例です:

import (
    "strings"
    "github.com/astaxie/beego"
)

type ApiController struct {
    beego.Controller
}

func (this *ApiController) Handle() {
    uri := this.Ctx.Request.RequestURI
    scriptPath := "/etc/nginx/conf.d/lua" + strings.TrimSuffix(uri, ".lua") + ".lua"
    this.Ctx.Output.ServeFile(scriptPath)
}

ログイン後にコピー

在上述代码中，我们首先获取请求的URI，然后根据URI构造出对应的Lua脚本路径，并调用http.ServeFile函数将脚本内容返回给OpenResty，从而实现动态加载脚本的目的。需要注意的是，我们需要对请求的后缀进行进一步处理，将.lua后缀去掉，并在路径中添加相应的前缀，才能正确地加载脚本文件。

总结

在本文中，我们介绍了如何在Beego中使用OpenResty实现高性能API网关。通过整合Beego和OpenResty的特性，我们实现了分布式路由、负载均衡和容错等核心功能，并为了实现安全性考虑，提供了授权、认证、访问控制等安全特性。在实际应用中，API网关还需要考虑缓存、反向代理、限流等特性，我们需要根据实际需要进行选取。

总的来说，Beego和OpenResty都是非常优秀的Web应用框架，它们的优势互补，可以帮助我们快速构建高性能和高可靠的Web应用。如果你还没有尝试过使用这两个框架，不妨想一想如何将它们应用到自己的项目中，相信会为你带来不少启示。

以上がOpenResty を使用して Beego に高性能 API ゲートウェイを実装するの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。