Alibaba Cloud DNS:Harmony SDK 開発者ガイド

ドメイン解決のベストプラクティス

事前解決と期限切れの応答を組み合わせて、最適なパフォーマンスを実現

ネットワークパフォーマンスが非常に重要となるシナリオでは、事前解決と「期限切れ応答の許可」戦略を組み合わせることを推奨します。この組み合わせにより、DNS 解決速度が大幅に向上し、ゼロレイテンシでの解決さえ実現可能です。

SDK の組み込みキャッシュ機構により、事前解決が完了した後は、ドメインに対する以降の解決リクエストが直接キャッシュをヒットします。これによりネットワークラウンドトリップが回避され、ユーザーエクスペリエンスが大幅に最適化されます。

1. 事前解決

キャッシュを有効化し、重要なドメインを事前解決します。この操作はアプリケーションの起動時に実行します。

EntryAbility の onCreate() メソッド内で、サービスで使用されるドメイン名を能動的に解決し、結果をローカルメモリにキャッシュします。

1. IPv4 専用シナリオ

// IPv4 のみをサポートするシナリオ向け。
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onCreate');

    let alipdns = Alipdns.getInstance();
    alipdns.Init(this.context,AccountID,AccessKeID,AccessKeySecret);
    // A レコード（IPv4）を事前解決。
    alipdns.preLoadDomains(alipdns.QTYPE_V4,['your-domain-to-preload-1.com','your-domain-to-preload-2.com']);
}

2. IPv6 サポート

// IPv6 サポートが必要なシナリオ向け。
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onCreate');

    let alipdns = Alipdns.getInstance();
    alipdns.Init(this.context,AccountID,AccessKeID,AccessKeySecret);
    // A レコードおよび AAAA レコード（IPv4 および IPv6）を事前解決。
    alipdns.preLoadDomains(alipdns.QTYPE_Auto,['your-domain-to-preload-1.com','your-domain-to-preload-2.com']);
}

2. 期限切れ応答の許可

ドメインを解決する際は、キャッシュを優先的に使用し、期限切れであってもまだ有効なキャッシュレコードの使用を許可します。これにより、レコードの TTL が有効期限切れになっていても、キャッシュがクリアされていなければ即座に結果を返すことができます。これによりゼロウェイト解決が実現します。

1. IPv4 専用シナリオ

    // IPv4 のみをサポートするシナリオ向け。
    
    // ************* HTTPDNS を使用したドメイン名の解決 - 開始 *************
    // A レコード（IPv4）を解決。
    let finalIps = await this.resolverHost(Alipdns.getInstance().QTYPE_V4,host);
    // ************* HTTPDNS を使用したドメイン名の解決 - 終了 *************
    
  /**
   * HTTPDNS ドメイン解決（キャッシュ優先、ネットワークフォールバック付き）
   * @param qtype - DNS クエリタイプ。例：Alipdns.getInstance().QTYPE_V4（A レコードを解決）。
   * @param host - 送信先ドメイン。
   * @returns 成功して解決された IP アドレスの配列。
   */
  async resolverHost(qtype: string, host: string): Promise<string[]> {
    // ************* HTTPDNS 解決：キャッシュ優先、ネットワークフォールバック *************
    let finalIps: string[] = [];

    // 1. IP アドレスをキャッシュから優先的に取得。第 3 パラメーターを true に設定することで、期限切れでも利用可能なレコードを返すことを許可します。
    try {
      const cacheResult = Alipdns.getInstance().getIpsByHostFromCache(qtype, host, true);
      // キャッシュ結果の検証。
      if (Array.isArray(cacheResult) && cacheResult.length > 0) {
        finalIps = cacheResult;
        console.log(`httpdns: [キャッシュヒット] ドメイン ${host} は ${finalIps.join(', ')} に解決されました。`);
      } else {
        console.log(`httpdns: [キャッシュミス／無効] ドメイン ${host}。ネットワークリクエストを開始します。`);
      }
    } catch (e) {
      console.warn(`httpdns: キャッシュクエリ例外：${e?.message || e}`);
    }

    // 2. キャッシュが無効な場合、ネットワークリクエストを開始。
    if (finalIps.length === 0) {
      try {
        finalIps = await this.getIpsFromNetwork(qtype, host);
        if (finalIps.length > 0) {
          console.log(`httpdns: [ネットワークリクエスト成功] ドメイン ${host} は ${finalIps.join(', ')} に解決されました。`);
        } else {
          console.warn(`httpdns: [ネットワークリクエスト] ドメイン ${host} は空の結果を返しました。`);
        }
      } catch (err) {
        console.error(`httpdns: [ネットワークリクエスト失敗] ドメイン ${host}：${err?.message || JSON.stringify(err)}`);
        // finalIps を空配列のままにして、システム DNS へフォールバックします。
      }
    }
    return finalIps;
  }

  // キャッシュが利用できない場合、ネットワークリクエストを送信してドメインを解決し、IP アドレスを取得します。
  getIpsFromNetwork(qtype: string, domain: string): Promise<string[]> {
    return new Promise((resolve) => {
      Alipdns.getInstance().getIpsByHostAsync(qtype, domain, (ips: string[]) => {
        if (Array.isArray(ips)) {
          resolve(ips);
        } else {
          resolve([]);
        }
      });
    });
  }

2. IPv6 サポート

    // IPv6 サポートが必要なシナリオ向け。
    
    // ************* HTTPDNS を使用したドメイン名の解決 - 開始 *************
    // A レコードおよび AAAA レコード（IPv4 および IPv6）を解決。
    let finalIps = await this.resolverHost(Alipdns.getInstance().QTYPE_Auto,host);
    // ************* HTTPDNS を使用したドメイン名の解決 - 終了 *************
    
  /**
   * HTTPDNS ドメイン解決（キャッシュ優先、ネットワークフォールバック付き）
   * @param qtype - DNS クエリタイプ。例：Alipdns.getInstance().QTYPE_Auto（A レコードおよび AAAA レコードを解決）。
   * @param host - 送信先ドメイン。
   * @returns 成功して解決された IP アドレスの配列。
   */
  async resolverHost(qtype: string, host: string): Promise<string[]> {
    // ************* HTTPDNS 解決：キャッシュ優先、ネットワークフォールバック *************
    let finalIps: string[] = [];

    // 1. IP アドレスをキャッシュから優先的に取得。第 3 パラメーターを true に設定することで、期限切れでも利用可能なレコードを返すことを許可します。
    try {
      const cacheResult = Alipdns.getInstance().getIpsByHostFromCache(qtype, host, true);
      // キャッシュ結果の検証。
      if (Array.isArray(cacheResult) && cacheResult.length > 0) {
        finalIps = cacheResult;
        console.log(`httpdns: [キャッシュヒット] ドメイン ${host} は ${finalIps.join(', ')} に解決されました。`);
      } else {
        console.log(`httpdns: [キャッシュミス／無効] ドメイン ${host}。ネットワークリクエストを開始します。`);
      }
    } catch (e) {
      console.warn(`httpdns: キャッシュクエリ例外：${e?.message || e}`);
    }

    // 2. キャッシュが無効な場合、ネットワークリクエストを開始。
    if (finalIps.length === 0) {
      try {
        finalIps = await this.getIpsFromNetwork(qtype, host);
        if (finalIps.length > 0) {
          console.log(`httpdns: [ネットワークリクエスト成功] ドメイン ${host} は ${finalIps.join(', ')} に解決されました。`);
        } else {
          console.warn(`httpdns: [ネットワークリクエスト] ドメイン ${host} は空の結果を返しました。`);
        }
      } catch (err) {
        console.error(`httpdns: [ネットワークリクエスト失敗] ドメイン ${host}：${err?.message || JSON.stringify(err)}`);
        // finalIps を空配列のままにして、システム DNS へフォールバックします。
      }
    }
    return finalIps;
  }

  // キャッシュが利用できない場合、ネットワークリクエストを送信してドメインを解決し、IP アドレスを取得します。
  getIpsFromNetwork(qtype: string, domain: string): Promise<string[]> {
    return new Promise((resolve) => {
      Alipdns.getInstance().getIpsByHostAsync(qtype, domain, (ips: string[]) => {
        if (Array.isArray(ips)) {
          resolve(ips);
        } else {
          resolve([]);
        }
      });
    });
  }

オンプレミス DNS

v2.0.0 以降、HTTPDNS Harmony SDK はオンプレミス DNS のプライベートデプロイメントをサポートします。

オンプレミス DNS モードは、金融、政府、大規模インターネット企業など、データコンプライアンスおよびカスタム解決ポリシーに対する要件が高いシナリオに適しています。SDK は、パブリッククラウド DNS 専用、オンプレミス DNS 専用、およびそれぞれを相互にフォールバック可能なハイブリッド主従モードの 4 つの典型的なデプロイモードをサポートします。この柔軟性により、多様なサービスアーキテクチャに対応できます。

コア機能

• プライベートデプロイメントのサポート：IPv4 アドレス、IPv6 アドレス、またはホスト名を使用してオンプレミス DNS サービスのエンドポイントを構成できます。

• 相互認証：通信のセキュリティを確保するため、顧客固有の accessKeyId および accessKeySecret を使用してリクエストに署名します。

• サーキットブレーカーおよびヘルスチェック：オンプレミス DNS ノードが連続して 3 回失敗した場合、サーキットブレーカーが自動的にトリガーされます。SDK は、指定された healthCheckDomain を使用して、1 分ごとにノードの可用性をプローブします。ノードが回復した場合、自動的に再有効化されます。

• インテリジェントなフォールバック解決：主 DNS（パブリッククラウド DNS またはオンプレミス DNS）の失敗回数が指定されたしきい値に達した場合、SDK は自動的にスタンバイ DNS に切り替えます。これにより、ドメイン解決の高可用性が確保されます。

• 既存 API とのシームレスな互換性：アプリケーションは、パブリッククラウド DNS およびオンプレミス DNS の両方に対して同じ方法で解決 API を呼び出し、ビジネスロジックを変更する必要はありません。

構成

let alipdns = Alipdns.getInstance();
alipdns.Init(this.context,AccountID,AccessKeyID,AccessKeySecret);

let alipdns = Alipdns.getInstance();
alipdns.InitFusionDNS(this.context,['1.1.X.X','2.2.X.X'],null, null,'443','your-health-check-domain.com','your-private-access-key-id','your-private-access-key-secret');

let alipdns = Alipdns.getInstance();

// 主：パブリッククラウド DNS
alipdns.Init(this.context,AccountID,AccessKeID,AccessKeySecret);
    
// 従：オンプレミス DNS
alipdns.InitFusionDNS(this.context,['1.1.X.X','2.2.X.X'],null, null,'443','your-health-check-domain.com','your-private-access-key-id','your-private-access-key-secret');

let alipdns = Alipdns.getInstance();
    
// 主：オンプレミス DNS
alipdns.InitFusionDNS(this.context,['1.1.X.X','2.2.X.X'],null, null,'443','your-health-check-domain.com','your-private-access-key-id','your-private-access-key-secret');

// 従：パブリッククラウド DNS
alipdns.Init(this.context,AccountID,AccessKeID,AccessKeySecret);

/**このメソッドは、オンプレミス DNS を使用するプライベートデプロイメント向けです。パブリック DNS のみを使用する場合は、このメソッドを呼び出す必要はありません。
     *
     * オンプレミス DNS のサーバーアドレスおよび認証情報を設定します。
     * 顧客は、プライベート DNS サーバーのアドレスおよび認証情報をこのインターフェイスを介して渡します。
     * SDK は、この情報を使用してリクエストを開始します。
     * @param ctx コンテキスト。
     * @param serverIpv4Arr IPv4 アドレスの配列。null を指定可能です。
     * @param serverIpv6Arr IPv6 アドレスの配列。null を指定可能です。
     * @param serverHostArr ホスト名の配列。null を指定可能です。
     * @param port サービスポート（例：「443」）。null を指定した場合、デフォルトポート「443」が使用されます。
     * @param healthCheckDomain サーキットブレーカー後のヘルスチェックに使用するドメイン。解決サービスが連続して 3 回以上失敗した場合、サーキットブレーカーがトリガーされ、サービスの IP アドレスがヘルスチェック状態に入ります。以降のリクエストはこのサービスにルーティングされません。タイマーはこのドメインを使用して、1 分ごとに解決インターフェイスを呼び出してサービスの可用性を確認します。プローブが成功した場合、サービスのステータスは「アクティブ」に復元され、以降のリクエストはこのサービスにルーティングされます。
     * @param accessKeyId 認証用のプライベート AccessKey ID。
     * @param accessKeySecret 認証用のプライベート AccessKey Secret。
     */
InitFusionDNS(
    ctx:Context,
    ipv4: string[] | null,
    ipv6: string[] | null,
    host: string[] | null,
    port: string | null,
    healthCheckDomain: string,
    accessKeyId: string,
    accessKeySecret: string
  )

/**パブリッククラウド DNS およびオンプレミス DNS の両方を構成している場合、このメソッドを使用して、主 DNS の失敗回数しきい値を設定し、スタンバイへのフォールバックをトリガーします。1 種類の DNS のみを構成している場合は、このメソッドは不要です。
   *
   * @param fallbackThreshold 失敗回数。主 DNS がパブリッククラウド DNS の場合のデフォルト値は 4、主 DNS がオンプレミス DNS の場合のデフォルト値は 2 です。
   *  有効な値は 0 ～ 4 です。値が 0 の場合、即時フォールバックが行われます。最大値は 4 です。
   */
   
setFallbackThreshold(fallbackThreshold:number);