Configuration: Update default web endpoints, and make them configurable

NEXT_CHANGELOG.md

@@ -27,6 +27,66 @@ By [@USERNAME](https://github.com/USERNAME) in https://github.com/apollographql/
 
 ## ❗ BREAKING ❗
 
+### Configuration: Update metrics and healthcheck web endpoints, and make them configurable ([#1500](https://github.com/apollographql/router/issues/1500))
+
+The web endpoints exposed by the router listen to 127.0.0.1 by default, and the ports and paths for health check and prometheus have changed.
+
+Here's the list of the endpoints exposed by the router:
+
+- GraphQL: http://127.0.0.1:4000/ (unchanged)
+- The GraphQL sandbox: http://127.0.0.1:4000/ (unchanged)
+- Prometheus metrics: http://127.0.0.1:9090/metrics (used to be http://127.0.0.1:4000/plugins/apollo.telemetry/prometheus)
+- Healthcheck: http://127.0.0.1:9494/health (used to be http://127.0.0.1:4000/.well-known/apollo/server-health)
+
+While you could previously only customize the path for these endpoints, you can now customize the full IP address, PORT and PATH.
+
+In order to enable this new feature, various `server` attributes such as `listen`, `graphql_path` and `landing_page` moved to more relevant sections.
+Likewise, `introspection` and `preview_defer_support` have moved from the `server` section to the `supergraph` section:
+
+This previous configuration: 
+```yaml
+server:
+  listen: 127.0.0.1:4000
+  graphql_path: /graphql
+  health_check_path: /health
+  introspection: false
+  preview_defer_support: true
+  landing_page: true
+telemetry:
+  metrics:
+    prometheus:
+      enabled: true
+```
+
+Now becomes:
+```yaml
+# landing_page configuration
+sandbox: 
+  listen: 127.0.0.1:4000
+  path: /
+  enabled: false # default
+# graphql_path configuration
+supergraph:
+  listen: 127.0.0.1:4000
+  path: /
+  introspection: false
+  preview_defer_support: true
+# health_check_path configuration
+health-check:
+  listen: 127.0.0.1:9494
+  path: /health
+  enabled: true # default
+# prometheus scraper configuration
+telemetry:
+  metrics:
+    prometheus:
+      listen: 127.0.0.1:9090
+      path: /metrics
+      enabled: true
+```
+
+By [@o0Ignition0o](https://github.com/o0Ignition0o) in https://github.com/apollographql/router/pull/1718
+
 ### `apollo-spaceport` and `uplink` are now part of `apollo-router` ([Issue #491](https://github.com/apollographql/router/issues/491))
 
 Instead of being dependencies, they are now part of the `apollo-router` crate.

RELEASE_CHECKLIST.md

@@ -36,8 +36,7 @@ in lieu of an official changelog.
 5. Update the `PACKAGE_VERSION` value in `scripts/install.sh` (it should be prefixed with `v`!)
 6. Update `docker.mdx` and `kubernetes.mdx` with the release version.
 7. Update `helm/chart/router/Chart.yaml` as follows:
-   - increment the version. e.g. `version: 0.1.2` becomes `version: 0.1.3`
-   - update the appVersion to the release version. e.g.: `appVersion: "v0.9.0"`
+   - update the version and the appVersion to the release version. e.g.: `appVersion: "v0.9.0"`
 8 Update `helm/chart/router/README.md` by running this from the repo root: `(cd helm/chart && helm-docs router)`.
   (If not installed, you should [install `helm-docs`](https://github.com/norwoodj/helm-docs))
 9. Update `federation-version-support.mdx` with the latest version info. Use https://github.com/apollographql/version_matrix to generate the version matrix.