3.4. マルチネットワークポリシーの設定

手順

1. ポリシールールを作成します。

   1. <policy_name>.yaml ファイルを作成します。

      $ touch <policy_name>.yaml

      Copy to Clipboard Toggle word wrap

      ここでは、以下のようになります。

      <policy_name>

      マルチネットワークポリシーのファイル名を指定します。

   2. 作成したばかりのファイルで、以下の例のようなマルチネットワークポリシーを定義します。

      すべての namespace のすべての Pod から Ingress を拒否します。

      これは基本的なポリシーであり、他のネットワークポリシーの設定によって許可されたクロス Pod トラフィック以外のすべてのクロス Pod ネットワーキングをブロックします。

      apiVersion: k8s.cni.cncf.io/v1beta1
      kind: MultiNetworkPolicy
      metadata:
        name: deny-by-default
        annotations:
          k8s.v1.cni.cncf.io/policy-for:<namespace_name>/<network_name>
      spec:
        podSelector: {}
        policyTypes:
        - Ingress
        ingress: []

      Copy to Clipboard Toggle word wrap

      ここでは、以下のようになります。

      <network_name>

      ネットワーク割り当て定義の名前を指定します。

      同じ namespace のすべての Pod から Ingress を許可する

      apiVersion: k8s.cni.cncf.io/v1beta1
      kind: MultiNetworkPolicy
      metadata:
        name: allow-same-namespace
        annotations:
          k8s.v1.cni.cncf.io/policy-for:<namespace_name>/<network_name>
      spec:
        podSelector:
        ingress:
        - from:
          - podSelector: {}

      Copy to Clipboard Toggle word wrap

      ここでは、以下のようになります。

      <network_name>

      ネットワーク割り当て定義の名前を指定します。

      特定の namespace から 1 つの Pod への Ingress トラフィックを許可する

      このポリシーは、namespacey で実行されている Pod から pod-a ラベルを持つ Pod へのトラフィックを許可します。

      apiVersion: k8s.cni.cncf.io/v1beta1
      kind: MultiNetworkPolicy
      metadata:
        name: allow-traffic-pod
        annotations:
          k8s.v1.cni.cncf.io/policy-for:<namespace_name>/<network_name>
      spec:
        podSelector:
         matchLabels:
            pod: pod-a
        policyTypes:
        - Ingress
        ingress:
        - from:
          - namespaceSelector:
              matchLabels:
                 kubernetes.io/metadata.name: namespace-y

      Copy to Clipboard Toggle word wrap

      ここでは、以下のようになります。

      <network_name>

      ネットワーク割り当て定義の名前を指定します。

      サービスへのトラフィックを制限する

      このポリシーを適用すると、app=bookstore と role=api の両方のラベルを持つすべての Pod に、app=bookstore というラベルを持つ Pod のみがアクセスできるようになります。この例では、アプリケーションは、ラベル app=bookstore および role=api でマークされた REST API サーバーである可能性があります。

      この例では、次のユースケースに対応します。

      • サービスへのトラフィックを、それを使用する必要がある他のマイクロサービスのみに制限します。

      • データベースへの接続を制限して、それを使用するアプリケーションのみを許可します。

        apiVersion: k8s.cni.cncf.io/v1beta1
        kind: MultiNetworkPolicy
        metadata:
          name: api-allow
          annotations:
            k8s.v1.cni.cncf.io/policy-for:<namespace_name>/<network_name>
        spec:
          podSelector:
            matchLabels:
              app: bookstore
              role: api
          ingress:
          - from:
              - podSelector:
                  matchLabels:
                    app: bookstore

        Copy to Clipboard Toggle word wrap

        ここでは、以下のようになります。

        <network_name>

        ネットワーク割り当て定義の名前を指定します。

2. マルチネットワークポリシーオブジェクトを作成するには、以下のコマンドを入力します。成功した出力には、ポリシーオブジェクトの名前と 作成された ステータスが一覧表示されます。

   $ oc apply -f <policy_name>.yaml -n <namespace>

   Copy to Clipboard Toggle word wrap

   ここでは、以下のようになります。

   <policy_name>

   マルチネットワークポリシーのファイル名を指定します。

   <namespace>

   オプションのパラメーター。現在の namespace 以外の namespace にオブジェクトを定義した場合、namespace を指定してパラメーターを指定します。

   成功した出力には、ポリシーオブジェクトの名前と 作成された ステータスが一覧表示されます。

手順

1. オプション: namespace のマルチネットワークポリシーオブジェクトをリスト表示するには、以下のコマンドを入力します。

   $ oc get multi-networkpolicy

   Copy to Clipboard Toggle word wrap

   ここでは、以下のようになります。

   <namespace>

   オプション: オブジェクトが現在の namespace 以外の namespace に定義されている場合は namespace を指定します。

2. マルチネットワークポリシーオブジェクトを編集します。

   • マルチネットワークポリシーの定義をファイルに保存した場合は、ファイルを編集して必要な変更を加えてから、以下のコマンドを入力します。

     $ oc apply -n <namespace> -f <policy_file>.yaml

     Copy to Clipboard Toggle word wrap

     ここでは、以下のようになります。

     <namespace>

     オプション: オブジェクトが現在の namespace 以外の namespace に定義されている場合は namespace を指定します。

     <policy_file>

     ネットワークポリシーを含むファイルの名前を指定します。

   • マルチネットワークポリシーオブジェクトを直接更新する必要がある場合、以下のコマンドを入力できます。

     $ oc edit multi-networkpolicy <policy_name> -n <namespace>

     Copy to Clipboard Toggle word wrap

     ここでは、以下のようになります。

     <policy_name>

     ネットワークポリシーの名前を指定します。

     <namespace>

     オプション: オブジェクトが現在の namespace 以外の namespace に定義されている場合は namespace を指定します。

3. マルチネットワークポリシーオブジェクトが更新されていることを確認します。

   $ oc describe multi-networkpolicy <policy_name> -n <namespace>

   Copy to Clipboard Toggle word wrap

   ここでは、以下のようになります。

   <policy_name>

   マルチネットワークポリシーの名前を指定します。

   <namespace>

   オプション: オブジェクトが現在の namespace 以外の namespace に定義されている場合は namespace を指定します。

手順

1. すべての namespace におけるすべての Pod からの Ingress を拒否する deny-by-default ポリシーを定義する次の YAML を作成します。YAML を deny-by-default.yaml ファイルに保存します。

   apiVersion: k8s.cni.cncf.io/v1beta1
   kind: MultiNetworkPolicy
   metadata:
     name: deny-by-default
     namespace: my-project 

   1

   
     annotations:
       k8s.v1.cni.cncf.io/policy-for:<namespace_name>/<network_name> 

   2

   
   spec:
     podSelector: {} 

   3

   
     policyTypes: 

   4

   
     - Ingress 

   5

   
     ingress: [] 

   6

   Copy to Clipboard Toggle word wrap

   1

   ポリシーをデプロイする namespace を指定します。たとえば、my-project namespace です。

   2

   namespace プロジェクトの名前と、それに続くネットワークアタッチメント定義名を指定します。

   3

   このフィールドが空の場合、設定はすべての Pod と一致します。したがって、ポリシーは my-project namespace 内のすべての Pod に適用されます。

   4

   NetworkPolicy が関連するルールタイプのリストを指定します。

   5

   Ingress 専用の policyTypes を指定します。

   6

   Ingress ルールを指定します。指定しない場合は、すべての Pod へのすべての着信トラフィックがドロップされます。

2. 次のコマンドを入力して、ポリシーを適用します。成功した出力には、ポリシーオブジェクトの名前と 作成された ステータスが一覧表示されます。

   $ oc apply -f deny-by-default.yaml

   Copy to Clipboard Toggle word wrap

   成功した出力には、ポリシーオブジェクトの名前と 作成された ステータスが一覧表示されます。

手順

1. パブリックインターネットからのトラフィックが直接、またはロードバランサーを使用して Pod にアクセスできるようにするポリシーを作成します。YAML を web-allow-external.yaml ファイルに保存します。

   apiVersion: k8s.cni.cncf.io/v1beta1
   kind: MultiNetworkPolicy
   metadata:
     name: web-allow-external
     namespace: default
     annotations:
       k8s.v1.cni.cncf.io/policy-for:<namespace_name>/<network_name>
   spec:
     policyTypes:
     - Ingress
     podSelector:
       matchLabels:
         app: web
     ingress:
       - {}

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを入力して、ポリシーを適用します。成功した出力には、ポリシーオブジェクトの名前と 作成された ステータスが一覧表示されます。

   $ oc apply -f web-allow-external.yaml

   Copy to Clipboard Toggle word wrap

   成功した出力には、ポリシーオブジェクトの名前と 作成された ステータスが一覧表示されます。このポリシーは、次の図に示すように、外部トラフィックを含むすべてのリソースからのトラフィックを許可します。

手順

1. すべての namespace のすべての Pod から特定のアプリケーションへのトラフィックを許可するポリシーを作成します。YAML を web-allow-all-namespaces.yaml ファイルに保存します。

   apiVersion: k8s.cni.cncf.io/v1beta1
   kind: MultiNetworkPolicy
   metadata:
     name: web-allow-all-namespaces
     namespace: default
     annotations:
       k8s.v1.cni.cncf.io/policy-for:<namespace_name>/<network_name>
   spec:
     podSelector:
       matchLabels:
         app: web 

   1

   
     policyTypes:
     - Ingress
     ingress:
     - from:
       - namespaceSelector: {} 

   2

   Copy to Clipboard Toggle word wrap

   1

   デフォルトの namespace の app:web Pod にのみポリシーを適用します。

   2

   すべての namespace のすべての Pod を選択します。

   注記

   デフォルトでは、ポリシーオブジェクトに namespaceSelector パラメーターを指定しないと、namespace は選択されません。これは、ポリシーがネットワークポリシーがデプロイされる namespace からのトラフィックのみを許可することを意味します。

2. 次のコマンドを入力して、ポリシーを適用します。成功した出力には、ポリシーオブジェクトの名前と 作成された ステータスが一覧表示されます。

   $ oc apply -f web-allow-all-namespaces.yaml

   Copy to Clipboard Toggle word wrap

   成功した出力には、ポリシーオブジェクトの名前と 作成された ステータスが一覧表示されます。

検証

1. 次のコマンドを入力して、default namespace で Web サービスを開始します。

   $ oc run web --namespace=default --image=nginx --labels="app=web" --expose --port=80

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行して、alpine イメージを secondary namespace にデプロイし、シェルを開始します。

   $ oc run test-$RANDOM --namespace=secondary --rm -i -t --image=alpine -- sh

   Copy to Clipboard Toggle word wrap

3. シェルで次のコマンドを実行し、サービスが要求を許可していることを確認します。

   # wget -qO- --timeout=2 http://web.default

   Copy to Clipboard Toggle word wrap

   予想される出力

   <!DOCTYPE html>
   <html>
   <head>
   <title>Welcome to nginx!</title>
   <style>
   html { color-scheme: light dark; }
   body { width: 35em; margin: 0 auto;
   font-family: Tahoma, Verdana, Arial, sans-serif; }
   </style>
   </head>
   <body>
   <h1>Welcome to nginx!</h1>
   <p>If you see this page, the nginx web server is successfully installed and
   working. Further configuration is required.</p>
   
   <p>For online documentation and support please refer to
   <a href="http://nginx.org/">nginx.org</a>.<br/>
   Commercial support is available at
   <a href="http://nginx.com/">nginx.com</a>.</p>
   
   <p><em>Thank you for using nginx.</em></p>
   </body>
   </html>

   Copy to Clipboard Toggle word wrap

手順

1. ラベルが purpose=production の特定の namespace 内にあるすべての Pod からのトラフィックを許可するポリシーを作成します。YAML を web-allow-prod.yaml ファイルに保存します。

   apiVersion: k8s.cni.cncf.io/v1beta1
   kind: MultiNetworkPolicy
   metadata:
     name: web-allow-prod
     namespace: default
     annotations:
       k8s.v1.cni.cncf.io/policy-for:<namespace_name>/<network_name>
   spec:
     podSelector:
       matchLabels:
         app: web 

   1

   
     policyTypes:
     - Ingress
     ingress:
     - from:
       - namespaceSelector:
           matchLabels:
             purpose: production 

   2

   Copy to Clipboard Toggle word wrap

   1

   デフォルトの namespace の app:web Pod にのみポリシーを適用します。

   2

   ラベルが purpose=production の namespace 内にある Pod のみにトラフィックを制限します。

2. 次のコマンドを入力して、ポリシーを適用します。成功した出力には、ポリシーオブジェクトの名前と 作成された ステータスが一覧表示されます。

   $ oc apply -f web-allow-prod.yaml

   Copy to Clipboard Toggle word wrap

   成功した出力には、ポリシーオブジェクトの名前と 作成された ステータスが一覧表示されます。

検証

1. 次のコマンドを入力して、default namespace で Web サービスを開始します。

   $ oc run web --namespace=default --image=nginx --labels="app=web" --expose --port=80

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行して、prod namespace を作成します。

   $ oc create namespace prod

   Copy to Clipboard Toggle word wrap

3. 次のコマンドを実行して、prod namespace にラベルを付けます。

   $ oc label namespace/prod purpose=production

   Copy to Clipboard Toggle word wrap

4. 次のコマンドを実行して、dev namespace を作成します。

   $ oc create namespace dev

   Copy to Clipboard Toggle word wrap

5. 次のコマンドを実行して、dev namespace にラベルを付けます。

   $ oc label namespace/dev purpose=testing

   Copy to Clipboard Toggle word wrap

6. 次のコマンドを実行して、alpine イメージを dev namespace にデプロイし、シェルを開始します。

   $ oc run test-$RANDOM --namespace=dev --rm -i -t --image=alpine -- sh

   Copy to Clipboard Toggle word wrap

7. シェルで次のコマンドを実行し、ブロックされた要求の理由を確認します。たとえば、予期される出力状態は wget: download timed out となっています。

   # wget -qO- --timeout=2 http://web.default

   Copy to Clipboard Toggle word wrap

8. 次のコマンドを実行して、alpine イメージを prod namespace にデプロイし、シェルを開始します。

   $ oc run test-$RANDOM --namespace=prod --rm -i -t --image=alpine -- sh

   Copy to Clipboard Toggle word wrap

9. シェルで次のコマンドを実行し、リクエストが許可されていることを確認します。

   # wget -qO- --timeout=2 http://web.default

   Copy to Clipboard Toggle word wrap

   予想される出力

   <!DOCTYPE html>
   <html>
   <head>
   <title>Welcome to nginx!</title>
   <style>
   html { color-scheme: light dark; }
   body { width: 35em; margin: 0 auto;
   font-family: Tahoma, Verdana, Arial, sans-serif; }
   </style>
   </head>
   <body>
   <h1>Welcome to nginx!</h1>
   <p>If you see this page, the nginx web server is successfully installed and
   working. Further configuration is required.</p>
   
   <p>For online documentation and support please refer to
   <a href="http://nginx.org/">nginx.org</a>.<br/>
   Commercial support is available at
   <a href="http://nginx.com/">nginx.com</a>.</p>
   
   <p><em>Thank you for using nginx.</em></p>
   </body>
   </html>

   Copy to Clipboard Toggle word wrap