diff --git a/README.md b/README.md index 7d7136a6c..da58119a7 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,47 @@ -# Cryostat + + + + + + [![CI build and push](https://github.com/cryostatio/cryostat3/actions/workflows/push-ci.yaml/badge.svg "Continuous Integration")](https://github.com/cryostatio/cryostat3/actions/workflows/push-ci.yaml) [![Quay Repository](https://img.shields.io/badge/Container_Image-cryostat/cryostat-teal.svg "Quay Repository")](https://quay.io/repository/cryostat/cryostat) [![Google Group : Cryostat Development](https://img.shields.io/badge/Google_Group-Cryostat_Development-blue.svg "Mailing List")](https://groups.google.com/g/cryostat-development) -## USING +A container-native JVM application which acts as a bridge to other containerized JVMs and exposes a secure API for producing, analyzing, and retrieving JDK Flight Recorder data from your cloud workloads. -Most users will be best served starting at [`cryostat.io`](https://cryostat.io), the documentation website for Cryostat. -Here you will find instructions on how to install Cryostat using the [Cryostat Operator](https://github.com/cryostatio/cryostat-operator), -how to configure your applications to enable connectivity, and how to use the Cryostat application. +## SEE ALSO + +* [cryostat.io](https://cryostat.io) : upstream documentation website with user + guides, tutorials, blog posts, and other user-facing content. Start here if + what you've read so far sounds interesting and you want to know more as a + **user**, rather than as a _developer_. Here you will find instructions on + how to install Cryostat using the + [Cryostat Operator](https://github.com/cryostatio/cryostat-operator), how to + configure your applications to enable connectivity, and how to use the + Cryostat application. + +* [cryostat-core](https://github.com/cryostatio/cryostat-core) : the core library + providing a convenience wrapper and headless stubs for use of JFR using + JDK Mission Control internals. + +* [cryostat-operator](https://github.com/cryostatio/cryostat-operator) : an Operator + for deploying Cryostat in your OpenShift or Kubernetes cluster. + +* [cryostat-helm](https://github.com/cryostatio/cryostat-helm): a Helm Chart for + deploying Cryostat in your OpenShift or Kubernetes cluster + +* [cryostat-web](https://github.com/cryostatio/cryostat-web) : the React frontend + included as a submodule in Cryostat and built into Cryostat's OCI images. + +* [JDK Mission Control](https://github.com/openjdk/jmc) : the desktop application + complement to JFR. Some parts of JMC are borrowed and re-used to form the basis of + Cryostat. JMC is still a recommended tool for more full-featured analysis of JFR + files beyond what Cryostat currently implements. + +* [binjr](https://github.com/binjr/binjr) : a timeseries visualization desktop + application which supports reading JFR files This repository contains the source code for Cryostat versions 3.0 and later. Cryostat (née "container-jfr") versions prior to 3.0 are located at [cryostatio/cryostat](https://github.com/cryostatio/cryostat). Container images from both are published to the same @@ -22,19 +55,24 @@ We welcome and appreciate any contributions from our community. Please visit our ## REQUIREMENTS -Build Requirements: -- Git -- JDK v17+ +Build requirements: +- git +- JDK 17+ - Maven v3+ - [Quarkus CLI](https://quarkus.io/guides/cli-tooling) v3.4.1+ (Recommended) - [Podman](https://podman.io/docs/installation) 4.7+ -Run Requirements: +Smoketest run requirements: - [`yq`](https://github.com/mikefarah/yq) v4.35.1+ - [`kompose`](https://kompose.io/installation/) v1.31.2+ - [docker-compose](https://docs.docker.com/compose/install/) v1.29.2 - [podman-docker](https://packages.fedoraproject.org/pkgs/podman/podman-docker/) (Optional) +General run requirements: +- an OpenShift or Kubernetes cluster + - recommended installation methods: [`cryostat-operator`](https://github.com/cryostatio/cryostat-operator) or [`cryostat-helm`](https://github.com/cryostatio/cryostat-helm) +- OR any other container platform which can host OCI containers + ## BUILD This project uses Quarkus, the Supersonic Subatomic Java Framework. diff --git a/docs/images/cryostat_icon_rgb_default.svg b/docs/images/cryostat_icon_rgb_default.svg new file mode 100644 index 000000000..9509dfc42 --- /dev/null +++ b/docs/images/cryostat_icon_rgb_default.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/images/cryostat_icon_rgb_reverse.svg b/docs/images/cryostat_icon_rgb_reverse.svg new file mode 100644 index 000000000..0f05fa189 --- /dev/null +++ b/docs/images/cryostat_icon_rgb_reverse.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/images/cryostat_logo_hori_rgb_default.svg b/docs/images/cryostat_logo_hori_rgb_default.svg new file mode 100644 index 000000000..76c9b2d02 --- /dev/null +++ b/docs/images/cryostat_logo_hori_rgb_default.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/images/cryostat_logo_hori_rgb_reverse.svg b/docs/images/cryostat_logo_hori_rgb_reverse.svg new file mode 100644 index 000000000..90b38d973 --- /dev/null +++ b/docs/images/cryostat_logo_hori_rgb_reverse.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/images/cryostat_logo_vert_rgb_default.svg b/docs/images/cryostat_logo_vert_rgb_default.svg new file mode 100644 index 000000000..c9588621a --- /dev/null +++ b/docs/images/cryostat_logo_vert_rgb_default.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/images/cryostat_logo_vert_rgb_reverse.svg b/docs/images/cryostat_logo_vert_rgb_reverse.svg new file mode 100644 index 000000000..5062b5e36 --- /dev/null +++ b/docs/images/cryostat_logo_vert_rgb_reverse.svg @@ -0,0 +1 @@ + \ No newline at end of file