diff --git a/docs/content/en/docs/how-tos/portforward/_index.md b/docs/content/en/docs/how-tos/portforward/_index.md index e9a8186d992..88888aa23f2 100755 --- a/docs/content/en/docs/how-tos/portforward/_index.md +++ b/docs/content/en/docs/how-tos/portforward/_index.md @@ -4,6 +4,22 @@ linkTitle: "Port forwarding" weight: 50 --- -This page discusses how to set up port forwarding for container ports from pods. - -{{% todo 1076 %}} +This page discusses how Skaffold sets up port forwarding for container ports from pods. When Skaffold deploys an application, it will automatically forward any ports mentioned in the pod spec. + +For example, if we have the following pod manifest, Skaffold will forward port 8000 to port 8000 on our machine: + +``` +apiVersion: v1 +kind: Pod +metadata: + name: example +spec: + containers: + - name: skaffold-example + image: gcr.io/k8s-skaffold/skaffold-example + ports: + - name: web + containerPort: 8000 +``` + +If port 8000 isn't available, another random port will be chosen.