From 6abdcec82731f6af4f6a08004443a6abd9d28e9b Mon Sep 17 00:00:00 2001
From: Sam Naser <samnaser@google.com>
Date: Wed, 20 Jan 2021 11:38:48 -0500
Subject: [PATCH] Service API task doc test (#8796)

* mark as tested

* generate snips

* test progress

* add -I to curl output in command

* regenerate snips

* doc test fixes

* Add HTTP/1.1 to expected output

* change to use verify_elided
---
 .../ingress/service-apis/index.md             |   4 +-
 .../ingress/service-apis/snips.sh             | 107 ++++++++++++++++++
 .../ingress/service-apis/test.sh              |  52 +++++++++
 3 files changed, 161 insertions(+), 2 deletions(-)
 create mode 100644 content/en/docs/tasks/traffic-management/ingress/service-apis/snips.sh
 create mode 100644 content/en/docs/tasks/traffic-management/ingress/service-apis/test.sh

diff --git a/content/en/docs/tasks/traffic-management/ingress/service-apis/index.md b/content/en/docs/tasks/traffic-management/ingress/service-apis/index.md
index 250a0f755b..c0381d5233 100644
--- a/content/en/docs/tasks/traffic-management/ingress/service-apis/index.md
+++ b/content/en/docs/tasks/traffic-management/ingress/service-apis/index.md
@@ -4,7 +4,7 @@ description: Describes how to configure the Kubernetes Service APIs with Istio.
 weight: 50
 keywords: [traffic-management,ingress]
 owner: istio/wg-networking-maintainers
-test: no
+test: yes
 ---
 
 This task describes how to configure Istio to expose a service outside of the service mesh cluster, using the Kubernetes [Service APIs](https://kubernetes-sigs.github.io/service-apis/).
@@ -102,7 +102,7 @@ See the [Service APIs](https://kubernetes-sigs.github.io/service-apis/) document
 1.  Access the _httpbin_ service using _curl_:
 
     {{< text bash >}}
-    $ curl -s -HHost:httpbin.example.com "http://$INGRESS_HOST:$INGRESS_PORT/get"
+    $ curl -s -I -HHost:httpbin.example.com "http://$INGRESS_HOST:$INGRESS_PORT/get"
     HTTP/1.1 200 OK
     server: istio-envoy
     ...
diff --git a/content/en/docs/tasks/traffic-management/ingress/service-apis/snips.sh b/content/en/docs/tasks/traffic-management/ingress/service-apis/snips.sh
new file mode 100644
index 0000000000..dea11d0a0c
--- /dev/null
+++ b/content/en/docs/tasks/traffic-management/ingress/service-apis/snips.sh
@@ -0,0 +1,107 @@
+#!/bin/bash
+# shellcheck disable=SC2034,SC2153,SC2155,SC2164
+
+# Copyright Istio Authors. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+####################################################################################################
+# WARNING: THIS IS AN AUTO-GENERATED FILE, DO NOT EDIT. PLEASE MODIFY THE ORIGINAL MARKDOWN FILE:
+#          docs/tasks/traffic-management/ingress/service-apis/index.md
+####################################################################################################
+
+snip_setup_1() {
+kubectl kustomize "github.com/kubernetes-sigs/service-apis/config/crd?ref=v0.1.0" | kubectl apply -f -
+}
+
+snip_setup_2() {
+istioctl install --set values.pilot.env.PILOT_ENABLED_SERVICE_APIS=true
+}
+
+snip_configuring_a_gateway_1() {
+kubectl apply -f samples/httpbin/httpbin.yaml
+}
+
+snip_configuring_a_gateway_2() {
+kubectl apply -f - <<EOF
+apiVersion: networking.x-k8s.io/v1alpha1
+kind: GatewayClass
+metadata:
+  name: istio
+spec:
+  controller: istio.io/gateway-controller
+---
+apiVersion: networking.x-k8s.io/v1alpha1
+kind: Gateway
+metadata:
+  name: gateway
+  namespace: istio-system
+spec:
+  gatewayClassName: istio
+  listeners:
+  - hostname: "*"
+    port: 80
+    protocol: HTTP
+    routes:
+      namespaces:
+        from: All
+      selector:
+        matchLabels:
+          selected: "yes"
+      kind: HTTPRoute
+---
+apiVersion: networking.x-k8s.io/v1alpha1
+kind: HTTPRoute
+metadata:
+  name: http
+  namespace: default
+  labels:
+    selected: "yes"
+spec:
+  gateways:
+    allow: All
+  hostnames: ["httpbin.example.com"]
+  rules:
+  - matches:
+    - path:
+        type: Prefix
+        value: /get
+    filters:
+    - type: RequestHeaderModifier
+      requestHeaderModifier:
+        add:
+          my-added-header: added-value
+    forwardTo:
+    - serviceName: httpbin
+      port: 8000
+EOF
+}
+
+snip_configuring_a_gateway_3() {
+curl -s -I -HHost:httpbin.example.com "http://$INGRESS_HOST:$INGRESS_PORT/get"
+}
+
+! read -r -d '' snip_configuring_a_gateway_3_out <<\ENDSNIP
+HTTP/1.1 200 OK
+server: istio-envoy
+...
+ENDSNIP
+
+snip_configuring_a_gateway_4() {
+curl -s -I -HHost:httpbin.example.com "http://$INGRESS_HOST:$INGRESS_PORT/headers"
+}
+
+! read -r -d '' snip_configuring_a_gateway_4_out <<\ENDSNIP
+HTTP/1.1 404 Not Found
+...
+ENDSNIP
diff --git a/content/en/docs/tasks/traffic-management/ingress/service-apis/test.sh b/content/en/docs/tasks/traffic-management/ingress/service-apis/test.sh
new file mode 100644
index 0000000000..f269767743
--- /dev/null
+++ b/content/en/docs/tasks/traffic-management/ingress/service-apis/test.sh
@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+# shellcheck disable=SC1090,SC2154
+
+# Copyright Istio Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+set -e
+set -u
+set -o pipefail
+
+source "tests/util/samples.sh"
+
+# @setup profile=none
+
+# install Service API CRDs
+snip_setup_1
+
+# install Istio with PILOT_ENABLED_SERVICE_APIS flag enabled
+istioctl install --set values.pilot.env.PILOT_ENABLED_SERVICE_APIS=true -y
+_wait_for_deployment istio-system istiod
+_wait_for_deployment istio-system istio-ingressgateway
+
+startup_httpbin_sample
+
+# setup the Gateway and GatewayClass
+snip_configuring_a_gateway_2
+
+# configure $INGRESS_HOST and $INGRESS_PORT
+_set_ingress_environment_variables
+
+# send CURL traffic to http://$INGRESS_HOST:$INGRESS_PORT/get (expected 200)
+_verify_elided snip_configuring_a_gateway_3 "$snip_configuring_a_gateway_3_out"
+
+# send CURL traffic to http://$INGRESS_HOST:$INGRESS_PORT/get (expected 404)
+_verify_elided snip_configuring_a_gateway_4 "$snip_configuring_a_gateway_4_out"
+
+
+# @cleanup
+cleanup_httpbin_sample
+kubectl kustomize "github.com/kubernetes-sigs/service-apis/config/crd?ref=v0.1.0" | kubectl delete -f -
+kubectl delete ns istio-system