update OpenAPI configs for all APIs to reflect online update

[davepacheco]

We need to update a lot of our APIs so that once self-service update ships (R17), CI will break if the API changes. See RFD 532 and the OpenAPI manager docs for details.

From Omicron:

• dns-server (already done)
• bootstrap-agent
• clickhouse-admin-keeper
• clickhouse-admin-server
• clickhouse-admin-single
• cockroach-admin
• gateway (MGS): gateway: versionify; use progenitor client in tests #8917
• installinator
• nexus internal
• nexus external is a special case -- see RFD 531
• ntp-admin
• oximeter
• repo-depot
• sled-agent

Outside of Omicron (see #8922 for detailed tracking):

• crucible-agent
• crucible-pantry
• crucible-repair
• ddm-admin
• dpd
• lldpd
• mg-admin
• propolis

I believe the following can remain "lockstep" because they really are only ever deployed with client and server in the same unit:

• Wicketd

---

For each one, we have a few options:

• The best way is to convert it to a versioned API. We should do this for everything in Omicron.
• Failing that, we could change tests to not use expectorate so that these cannot be so easily changed. This might be an okay stopgap for non-Omicron APIs prior to having done OpenAPI manager should be usable by other repos #7569.

We may actually want to eliminate the ability to change these client-side-managed APIs automatically because we don't have the infra to support that at runtime yet:

• bootstrap-agent
• nexus-internal
• installinator
• crucible-repair
• repo-depot

[iliana]

The Oximeter producer API is a special case, right? This API is not managed with the OpenAPI manager.

[davepacheco]

Oximeter is managed with the OpenAPI manager:
https://github.com/oxidecomputer/omicron/blob/main/dev-tools/openapi-manager/src/omicron.rs#L140-L148

[sunshowers]

I think there's a separate Oximeter producer API that isn't managed that way:

omicron/oximeter/producer/src/lib.rs

Lines 388 to 393 in 8bb6386

	// Register API endpoints of the `Server`.
	fn metric_server_api() -> ApiDescription<ProducerRegistry> {
	let mut api = ApiDescription::new();
	api.register(collect).expect("Failed to register handler for collect");
	api
	}

To be honest I think I just missed this one while doing the conversions to openapi-manager.

[davepacheco]

For the "outside of Omicron" list, the work is covered by #8922.