Red Hat Summit Red Hat SummitSupportKonsoleEntwicklerDemo startenKontakt

Dieser Inhalt ist in der von Ihnen ausgewählten Sprache nicht verfügbar.

Chapter 12. Networking

12.1. Using Service Mesh with OpenShift Serverless
Link kopieren

Using Service Mesh with OpenShift Serverless enables developers to configure additional networking and routing options that are not supported when using OpenShift Serverless with the default Kourier implementation. These options include setting custom domains, using TLS certificates, and using JSON Web Token authentication.

Prerequisites

  1. Install the OpenShift Serverless Operator and Knative Serving.
  2. Install Red Hat OpenShift Service Mesh.

Procedure

  1. Add the default namespace to the ServiceMeshMemberRoll as a member: 

    apiVersion: maistra.io/v1
kind: ServiceMeshMemberRoll
metadata:
  name: default
  namespace: istio-system
spec:
  members:
    - default
    Copy to Clipboard Toggle word wrap
    Important

    Adding sidecar injection to Pods in system namespaces such as knative-serving and knative-serving-ingress is not supported.

  2. Create a network policy that permits traffic flow from Knative system pods to Knative services:

    1. Add the serving.knative.openshift.io/system-namespace=true label to the knative-serving namespace: 

      $ oc label namespace knative-serving serving.knative.openshift.io/system-namespace=true
      Copy to Clipboard Toggle word wrap

    2. Add the serving.knative.openshift.io/system-namespace=true label to the knative-serving-ingress namespace: 

      $ oc label namespace knative-serving-ingress serving.knative.openshift.io/system-namespace=true
      Copy to Clipboard Toggle word wrap

    3. Copy the following NetworkPolicy resource into a YAML file: 

      apiVersion: networking.k8s.io/v1
kind: NetworkPolicy
metadata:
  name: allow-from-serving-system-namespace
  namespace: default
spec:
  ingress:
  - from:
    - namespaceSelector:
        matchLabels:
          serving.knative.openshift.io/system-namespace: "true"
  podSelector: {}
  policyTypes:
  - Ingress
      Copy to Clipboard Toggle word wrap

    4. Apply the NetworkPolicy resource: 

      $ oc apply -f <filename>
      Copy to Clipboard Toggle word wrap

12.1.1. Enabling sidecar injection for a Knative service
Link kopieren

You can add an annotation to the Service resource YAML file to enable sidecar injection for a Knative service.

Procedure

  1. Add the sidecar.istio.io/inject="true" annotation to the Service resource: 

    apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: hello-example-1
spec:
  template:
    metadata:
      annotations:
        sidecar.istio.io/inject: "true"
    1 
    
    spec:
      containers:
      - image: docker.io/openshift/hello-openshift
        name: container
    Copy to Clipboard Toggle word wrap
    1
    Add the sidecar.istio.io/inject="true" annotation.

  2. Apply the Service resource YAML file: 

    $ oc apply -f <filename>
    Copy to Clipboard Toggle word wrap

12.1.2. Additional resources
Link kopieren

You can enable JSON Web Token (JWT) authentication for Knative services by creating a policy in your serverless application namespace that only allows requests with valid JWTs.

Prerequisites

Important

Adding sidecar injection to pods in system namespaces such as knative-serving and knative-serving-ingress is not supported.

Procedure

  1. Copy the following Policy resource into a YAML file:

    Important

    The paths /metrics and /healthz must be included in excludedPaths because they are accessed from system pods in the knative-serving namespace. 

    apiVersion: authentication.istio.io/v1alpha1
kind: Policy
metadata:
  name: default
spec:
  origins:
  - jwt:
      issuer: testing@secure.istio.io
      jwksUri: "https://raw.githubusercontent.com/istio/istio/release-1.6/security/tools/jwt/samples/jwks.json"
      triggerRules:
      - excludedPaths:
        - prefix: /metrics
        - prefix: /healthz
  principalBinding: USE_ORIGIN
    Copy to Clipboard Toggle word wrap

  2. Apply the Policy resource YAML file: 

    $ oc apply -f <filename>
    Copy to Clipboard Toggle word wrap

Verification

  1. If you try to use a curl request to get the Knative service URL, it is denied. 

    $ curl http://hello-example-default.apps.mycluster.example.com/
    Copy to Clipboard Toggle word wrap

    Example output

    Origin authentication failed.
    Copy to Clipboard Toggle word wrap

  2. Verify the request with a valid JWT.

    1. Get the valid JWT token by entering the following command: 

      $ TOKEN=$(curl https://raw.githubusercontent.com/istio/istio/release-1.6/security/tools/jwt/samples/demo.jwt -s) && echo "$TOKEN" | cut -d '.' -f2 - | base64 --decode -
      Copy to Clipboard Toggle word wrap

    2. Access the service by using the valid token in the curl request header: 

      $ curl http://hello-example-default.apps.mycluster.example.com/ -H "Authorization: Bearer $TOKEN"
      Copy to Clipboard Toggle word wrap

      The request is now allowed.

      Example output

      Hello OpenShift!
      Copy to Clipboard Toggle word wrap

12.2.1. Additional resources
Link kopieren

12.3. Using custom domains for Knative services with Service Mesh
Link kopieren

By default, Knative services have a fixed domain format: 

 <application_name>-<namespace>.<openshift_cluster_domain>
Copy to Clipboard Toggle word wrap

You can customize the domain for your Knative service by configuring the service as a private service and creating the required Service Mesh resources.

Prerequisites

12.3.1. Setting cluster availability to cluster-local
Link kopieren

By default, Knative services are published to a public IP address. Being published to a public IP address means that Knative services are public applications, and have a publicly accessible URL.

Publicly accessible URLs are accessible from outside of the cluster. However, developers may need to build back-end services that are only be accessible from inside the cluster, known as private services. Developers can label individual services in the cluster with the serving.knative.dev/visibility=cluster-local label to make them private.

Procedure

  • Set the visibility for your service by adding the serving.knative.dev/visibility=cluster-local label: 

    $ oc label ksvc <service_name> serving.knative.dev/visibility=cluster-local
    Copy to Clipboard Toggle word wrap

Verification

  • Check that the URL for your service is now in the format http://<service_name>.<namespace>.svc.cluster.local, by entering the following command and reviewing the output: 

    $ oc get ksvc
    Copy to Clipboard Toggle word wrap

    Example output

    NAME            URL                                                                         LATESTCREATED     LATESTREADY       READY   REASON
hello           http://hello.default.svc.cluster.local                                      hello-tx2g7       hello-tx2g7       True
    Copy to Clipboard Toggle word wrap

12.3.2. Creating necessary Service Mesh resources
Link kopieren

Procedure

  1. Create an Istio gateway to accept traffic.

    1. Create a YAML file, and copy the following YAML into it: 

      apiVersion: networking.istio.io/v1alpha3
kind: Gateway
metadata:
  name: default-gateway
spec:
  selector:
    istio: ingressgateway
  servers:
  - port:
      number: 80
      name: http
      protocol: HTTP
    hosts:
    - "*"
      Copy to Clipboard Toggle word wrap

    2. Apply the YAML file: 

      $ oc apply -f <filename>
      Copy to Clipboard Toggle word wrap

  2. Create an Istio VirtualService object to rewrite the host header.

    1. Create a YAML file, and copy the following YAML into it: 

      apiVersion: networking.istio.io/v1alpha3
kind: VirtualService
metadata:
  name: hello
spec:
  hosts:
  - custom-ksvc-domain.example.com
  gateways:
  - default-gateway
  http:
  - rewrite:
      authority: hello.default.svc
      1 
      
    route:
    - destination:
        host: hello.default.svc
      2 
      
        port:
          number: 80
      Copy to Clipboard Toggle word wrap
      1 2
      Your Knative service in the format <service_name>.<namespace>.svc.

    2. Apply the YAML file: 

      $ oc apply -f <filename>
      Copy to Clipboard Toggle word wrap

  3. Create an Istio ServiceEntry object. This is required for OpenShift Serverless because Kourier is outside of the service mesh.

    1. Create a YAML file, and copy the following YAML into it: 

      apiVersion: networking.istio.io/v1alpha3
kind: ServiceEntry
metadata:
  name: hello.default.svc
spec:
  hosts:
  - hello.default.svc
      1 
      
  location: MESH_EXTERNAL
  endpoints:
  - address: kourier-internal.knative-serving-ingress.svc
  ports:
  - number: 80
    name: http
    protocol: HTTP
  resolution: DNS
      Copy to Clipboard Toggle word wrap
      1
      Your Knative service in the format <service_name>.<namespace>.svc.

    2. Apply the YAML file: 

      $ oc apply -f <filename>
      Copy to Clipboard Toggle word wrap

  4. Create an OpenShift Container Platform route that points to the VirtualService object.

    1. Create a YAML file, and copy the following YAML into it: 

      apiVersion: route.openshift.io/v1
kind: Route
metadata:
  name: hello
  namespace: istio-system
      1 
      
spec:
  host: custom-ksvc-domain.example.com
  port:
    targetPort: 8080
  to:
    kind: Service
    name: istio-ingressgateway
      Copy to Clipboard Toggle word wrap
1
The OpenShift Container Platform route must be created in the same namespace as the ServiceMeshControlPlane. In this example, the ServiceMeshControlPlane is deployed in the istio-system namespace.

  1. Apply the YAML file: 

    $ oc apply -f <filename>
    Copy to Clipboard Toggle word wrap

12.3.3. Accessing a service using your custom domain
Link kopieren

Procedure

  1. Access the custom domain by using the Host header in a curl request. For example: 

    $ curl -H "Host: custom-ksvc-domain.example.com" http://<ip_address>
    Copy to Clipboard Toggle word wrap

    where <ip_address> is the IP address that the OpenShift Container Platform ingress router is exposed to.

    Example output

    Hello OpenShift!
    Copy to Clipboard Toggle word wrap

12.3.4. Additional resources
Link kopieren

Nach oben
Red Hat logoGithubredditYoutubeTwitter

Lernen

Testen, kaufen und verkaufen

Communitys

Über Red Hat Dokumentation

Wir helfen Red Hat Benutzern, mit unseren Produkten und Diensten innovativ zu sein und ihre Ziele zu erreichen – mit Inhalten, denen sie vertrauen können. Entdecken Sie unsere neuesten Updates.

Mehr Inklusion in Open Source

Red Hat hat sich verpflichtet, problematische Sprache in unserem Code, unserer Dokumentation und unseren Web-Eigenschaften zu ersetzen. Weitere Einzelheiten finden Sie in Red Hat Blog.

Über Red Hat

Wir liefern gehärtete Lösungen, die es Unternehmen leichter machen, plattform- und umgebungsübergreifend zu arbeiten, vom zentralen Rechenzentrum bis zum Netzwerkrand.

Theme

© 2025 Red Hat