種類ごとにリソース全体を除外する
より複雑なテナントでは、リソースタイプごと丸ごと除外したくなることがあります。たとえば、次のようなケースです。- 何千もの組織を持つエンタープライズテナントで、それらすべてを管理するのは運用上大きな負担になる場合。
- CI/CD プロセスではロールの管理にのみ注力しており、それ以外はすべて除外したい場合。
- 機能開発の対象がフックに関するもので、パフォーマンスを最適化するために一時的にそれ以外をすべて除外したい場合。
AUTH0_EXCLUDED または AUTH0_INCLUDED_ONLY のいずれかの設定プロパティに、リソース名の配列を渡して指定します。AUTH0_EXCLUDED 設定プロパティは、指定されたリソースタイプのみを除外します。逆に、AUTH0_INCLUDED_ONLY プロパティは、定義したもの以外のすべてを除外します。除外は双方向に機能します。つまり、リソース設定ファイルの有無にかかわらず、Auth0 からのエクスポート時と Auth0 へのインポート時の両方に適用されます。
除外でサポートされるすべてのリソース値: actions, attackProtection, branding, clientGrants, clients, connections, customDomains, databases, emailProvider, emailTemplates, guardianFactorProviders, guardianFactorTemplates, guardianFactors, guardianPhoneFactorMessageTypes, guardianPhoneFactorSelectedProvider, guardianPolicies, logStreams, migrations, organizations, pages, prompts, resourceServers, roles, tenant, triggers.
除外の例
次の例では、Deploy CLI の管理対象からclients、connections、databases、organizations を除外する方法を示します。
含める場合の例
次の例は、Deploy CLI でactions、clients、connections のみを管理するように指定する方法を示しています。
ID で個別のリソースを除外する
一部のリソースタイプでは、ID を指定して個々のリソースを除外できます。これは、複数の環境で作業していて、下位環境から本番環境固有のリソースを除外したい場合に便利です。 この方法は、ルール、クライアント、データベース、接続、および でサポートされており、それぞれAUTH0_EXCLUDED_RULES、AUTH0_EXCLUDED_CLIENTS、AUTH0_EXCLUDED_DATABASES、AUTH0_EXCLUDED_CONNECTIONS、AUTH0_EXCLUDED_RESOURCE_SERVERS の構成値を使用します。
例
ID によるリソースの除外は、将来のメジャーバージョンで非推奨になる可能性があります。詳細については、resource exclusion proposalを参照してください。
省略と空の状態
Auth0 Deploy CLI では、双方向で設定を強制的に無視する「リソースの除外」に加えて、これに類似した 2 つの概念である「省略」と「空の状態」もサポートしています。省略
意図的かどうかを問わず、存在しないリソース設定はインポート時にスキップされます。たとえば、リソース設定が削除されている場合、その設定はインポート時にスキップされ、リモートテナントの状態は変更されません。 エクスポートでは、省略という考え方はありません。明示的に除外しない限り、すべてのテナント設定がリソース設定ファイルに書き出されます。例
空
明示的に空であると定義されたリソース設定です。hooks、組織、アクションのような集合ベースの構成では、これらの構成を空集合に設定することで、それらのリソースを意図的に空にすることを示します。これは削除の意思表示となり、削除設定プロパティAUTH0_ALLOW_DELETE が有効になっている場合に限り、削除として扱われます。このプロパティの詳細については、Deploy CLI を設定するを参照してください。
テナントやブランディングのような非集合ベースのリソース設定には、空という概念は適用されず、削除や除去は発生しません。