Cluster Director API C++ Client Library

An idiomatic C++ client library for the Cluster Director API.

The Cluster Director API allows you to deploy, manage, and monitor clusters that run AI, ML, or HPC workloads.

While this library is GA, please note that the Google Cloud C++ client libraries do not follow Semantic Versioning.

Quickstart

The following shows the code that you'll run in the google/cloud/hypercomputecluster/quickstart/ directory, which should give you a taste of the Cluster Director API C++ client library API.

#include "google/cloud/hypercomputecluster/v1/hypercompute_cluster_client.h"
#include "google/cloud/location.h"
#include <iostream>

int main(int argc, char* argv[]) try {
  if (argc != 3) {
    std::cerr << "Usage: " << argv[0] << " project-id location-id\n";
    return 1;
  }

  auto const location = google::cloud::Location(argv[1], argv[2]);

  namespace hypercomputecluster = ::google::cloud::hypercomputecluster_v1;
  auto client = hypercomputecluster::HypercomputeClusterClient(
      hypercomputecluster::MakeHypercomputeClusterConnection());

  for (auto r : client.ListClusters(location.FullName())) {
    if (!r) throw std::move(r).status();
    std::cout << r->DebugString() << "\n";
  }

  return 0;
} catch (google::cloud::Status const& status) {
  std::cerr << "google::cloud::Status thrown: " << status << "\n";
  return 1;
}

Main classes

The main class in this library is hypercomputecluster_v1::HypercomputeClusterClient. All RPCs are exposed as member functions of this class. Other classes provide helpers, configuration parameters, and infrastructure to mock hypercomputecluster_v1::HypercomputeClusterClient when testing your application.

More Information