How-To: Kubernetes base YAML guide

docs/content/guides/author-apps/kubernetes/howto-yaml-base-support/index.md

@@ -0,0 +1,50 @@
+---
+type: docs
+title: "How-To: Incremental onboard from existing Kubernetes resources"
+linkTitle: "Incremental onboard from existing Kubernetes resources"
+description: "Learn how to load a Kubernetes YAML base manifest into Radius and have Radius override properties on top of the user-given base resources"
+weight: 500
+categories: "How-To"
+tags: ["Kubernetes"]
+---
+
+### Prerequisites
+
+Before you get started, you'll need to make sure you have the following tools and resources:
+
+- [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/)
+- [Radius initialized with `rad init`]({{< ref howto-environment >}})
+
+### Step 1: Author a Radius Application
+
+Define a Radius Application resource that will contain your Kubernetes resource container.
+
+> Application-scoped resources are by default generated in a new Kubernetes namespace with the name format `<envNamespace>-<appname>`. This prevents multiple applications with resources of the same name from conflicting with each other, however users can define their own Kubernetes namespace if they desire.
+
+{{< rad file="snippets/basemanifest.bicep" embed=true marker="//APPLICATION" >}}
+
+### Step 2: Map your Kubernetes base YAML file to a Radius container resource
+
+You'll need to create a Radius container resource that will consume the information found in your Kubernetes base YAML file.
+
+#### Standardize object names
+
+Begin by assuring that your `ServiceAccount`, `Deployment`, and `Service` objects found in your Kubernetes base YAML file have the same name as the Radius container resource that lives inside your application-scoped namespace.
+
+#### Container configurations
+
+Define your Radius container resource port with the port of your Kubernetes `Service` as well as the image container location that your service is dependent on.
+
+#### Runtime configuration
+
+Load your Kubernetes YAML file into your Radius container resource through the `properties.runtimes.kubernetes.base` property which expects a string value containing all your Kubernetes data.
+
+{{< rad file="snippets/basemanifest.bicep" embed=true marker="//CONTAINER" >}}
+
+### Done
+
+You can now deploy your Radius Application and verify that your Kubernetes objects are created in the desired namespace. Visit the Radius [Kubernetes resources authoring overview]({{< ref "/guides/author-apps/kubernetes/overview" >}}) page for more information.
+
+## Further reading
+
+- [Kubernetes authoring resources overview]({{< ref "/guides/author-apps/kubernetes/overview" >}})

docs/content/guides/author-apps/kubernetes/howto-yaml-base-support/snippets/basemanifest.bicep

@@ -0,0 +1,62 @@
+import radius as radius
+
+@description('Specifies the location for resources.')
+param location string = 'global'
+
+@description('Specifies the image of the container resource.')
+param magpieimage string = 'ghcr.io/radius-project/dev/magpiego:pr-498da3203f'
+
+@description('Specifies the port of the container resource.')
+param port int = 3000
+
+@description('Specifies the environment for resources.')
+param environment string
+
+@description('Specifies the namespace for resources.')
+param namespace string
+
+//APPLICATION
+resource app 'Applications.Core/applications@2022-03-15-privatepreview' = {
+  name: 'manifest-default'
+  location: location
+  properties: {
+    environment: environment
+    extensions: [
+      {
+          kind: 'kubernetesNamespace'
+          namespace: namespace
+      }
+    ]
+  }
+}
+//APPLICATION
+
+//CONTAINER
+@description('Loads the Kubernetes base manifest file and turns content into a string.')
+var manifest = loadTextContent('./basemanifest.yaml')
+
+resource container 'Applications.Core/containers@2022-03-15-privatepreview' = {
+  // Name must match with `ServiceAccount`, `Deployment`, and `Service` objects
+  name: 'your-manifest-default-name'
+  location: location
+  properties: {
+    application: app.id
+    container: {
+      // Points to your container image
+      image: magpieimage
+      ports: {
+        web: {
+          // Port must match with `Service` object port
+          containerPort: port
+        }
+      }
+    }
+    connections: {}
+    runtimes: {
+      kubernetes: {
+        base: manifest
+      }
+    }
+  }
+}
+//CONTAINER

docs/content/guides/author-apps/kubernetes/howto-yaml-base-support/snippets/basemanifest.yaml

@@ -0,0 +1,96 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: manifest-default
+  labels:
+    app: manifest-default
+  annotations:
+    source: base-manifest-test
+spec:
+  replicas: 3
+  selector:
+    matchLabels:
+      app: manifest-default
+  template:
+    metadata:
+      labels:
+        app: manifest-default
+    spec:
+      serviceAccountName: manifest-default
+      volumes:
+        - name: secret-vol
+          secret:
+            secretName: manifest-default-secret0
+      containers:
+        - name: manifest-default
+          ports:
+          - containerPort: 80
+            protocol: TCP
+          volumeMounts:
+          - name: secret-vol
+            readOnly: true
+            mountPath: /etc/secret-vol
+          env:
+          - name: TEST_SECRET_KEY
+            valueFrom:
+              secretKeyRef:
+                name: manifest-default-secret1
+                key: secret1
+          - name: TEST_CONFIGMAP_KEY
+            valueFrom:
+              configMapKeyRef:
+                name: manifest-default-config
+                key: TEST_CONFIGMAP
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: manifest-default
+  annotations:
+    source: base-manifest-test
+spec:
+  selector:
+    app.kubernetes.io/name: manifest-default
+  ports:
+    - protocol: TCP
+      port: 3000
+      targetPort: 3000
+---
+apiVersion: v1
+kind: ServiceAccount
+metadata:
+  name: manifest-default
+  annotations:
+    source: base-manifest-test
+---
+# Not supported in Radius yet
+apiVersion: v1
+kind: Secret
+metadata:
+  name: manifest-default-secret0
+  annotations:
+    source: base-manifest-test
+type: Opaque
+stringData:
+  'secret0': test-secret-0
+---
+# Not supported in Radius yet
+apiVersion: v1
+kind: Secret
+metadata:
+  name: manifest-default-secret1
+  annotations:
+    source: base-manifest-test
+type: Opaque
+stringData:
+  'secret1': test-secret-1
+---
+# Not supported in Radius yet
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: manifest-default-config
+  annotations:
+    source: base-manifest-test
+data:
+  TEST_CONFIGMAP: test-configmap