Method RuntimeAPIVersion

pkg/compose/compose.go:511–531

RuntimeAPIVersion returns the negotiated API version that will be used for requests to the Docker daemon. It triggers version negotiation via Ping so that version-gated request shaping matches the version subsequent API calls will actually use. After negotiation, Compose should never rely on featur

(ctx context.Context)

// After negotiation, Compose should never rely on features or request attributes
// not defined by this API version, even if the daemon's raw version is higher.
func (s *composeService) RuntimeAPIVersion(ctx context.Context) (string, error) {
	s.runtimeAPIVersion.mu.Lock()
	defer s.runtimeAPIVersion.mu.Unlock()
	if s.runtimeAPIVersion.val != "" {
		return s.runtimeAPIVersion.val, nil
	}

	cli := s.apiClient()
	_, err := cli.Ping(ctx, client.PingOptions{NegotiateAPIVersion: true})
	if err != nil {
		return "", err
	}

	version := cli.ClientVersion()
	if version == "" {
		return "", fmt.Errorf("docker client returned empty version after successful API negotiation")
	}

	s.runtimeAPIVersion.val = version
	return s.runtimeAPIVersion.val, nil
}