Skip to content
This repository has been archived by the owner on Oct 14, 2024. It is now read-only.

Commit

Permalink
docs: remove documentation already available at openclarity.io (#1297)
Browse files Browse the repository at this point in the history
* docs: remove tour available at https://openclarity.io/docs/vmclarity/getting-started/first-tasks/

* docs: remove depricated architecture

* docs: remove aws installation available at https://openclarity.io/docs/vmclarity/getting-started/deploy-aws/

* docs: remove docker installation available at https://openclarity.io/docs/vmclarity/getting-started/deploy-docker/

* docs: remove gcp installation available at https://openclarity.io/docs/vmclarity/getting-started/deploy-gcp/

* docs: install and ui instructions from main readme
  • Loading branch information
paralta authored Feb 15, 2024
1 parent 09a9adc commit 71a17d9
Show file tree
Hide file tree
Showing 16 changed files with 3 additions and 222 deletions.
53 changes: 3 additions & 50 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Join [VMClarity's Slack channel](https://outshift.slack.com/messages/vmclarity)
# Table of Contents<!-- omit in toc -->

- [Why VMClarity?](#why-vmclarity)
- [Quick Start](#quick-start)
- [Getting started](#getting-started)
- [Overview](#overview)
- [Roadmap](#roadmap)
- [Contributing](#contributing)
Expand Down Expand Up @@ -50,56 +50,9 @@ However, there are challenges with assembling and managing these tools yourself:

The VMClarity project is focused on unifying detection and management of VM security threats in an agentless manner.

# Quick start
# Getting started

## Install VMClarity

### AWS

1. Start the CloudFormation [wizard](https://console.aws.amazon.com/cloudformation/home#/stacks/create/review?stackName=VMClarity&templateURL=https://vmclarity-cfn.s3.eu-central-1.amazonaws.com/0.6.0/VmClarity.cfn), or upload the [latest](https://github.com/openclarity/vmclarity/releases/latest) CloudFormation template
2. Specify the SSH key to be used to connect to VMClarity under 'KeyName'
3. Once deployed, copy VmClarity SSH Address from the "Outputs" tab

For a detailed installation guide, please see [AWS](installation/aws/README.md).

### Azure

1. Click the [![Deploy To Azure](https://docs.microsoft.com/en-us/azure/templates/media/deploy-to-azure.svg)](https://portal.azure.com/#blade/Microsoft_Azure_CreateUIDef/CustomDeploymentBlade/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fopenclarity%2Fvmclarity%2Fmain%2Finstallation%2Fazure%2Fvmclarity.json/uiFormDefinitionUri/https%3A%2F%2Fraw.githubusercontent.com%2Fopenclarity%2Fvmclarity%2Fmain%2Finstallation%2Fazure%2Fvmclarity-UI.json) button.
2. Fill out the required fields in the wizard
3. Once deployed, copy the VMClarity SSH address from the Outputs tab

### GCP

1. Change directory to `installation/gcp/dm`
2. Copy `vmclarity-config.example.yaml` to `vmclarity-config.yaml`, update with required values.
3. Deploy vmclarity using GCP deployment manager
```
gcloud deployment-manager deployments create <vmclarity deployment name> --config vmclarity-config.yaml
```
4. Once deployed, copy the VMClarity SSH IP address from the CLI output.

### Kubernetes

1. helm install -n vmclarity --create-namespace vmclarity ./vmclarity

## Access VMClarity UI

1. Open connection to VMClarity API Gateway either:

* On AWS, Azure or GCP, open an SSH tunnel to VMClarity VM server
```
ssh -N -L 8080:localhost:80 -i "<Path to the SSH key specified during install>" ubuntu@<VmClarity SSH Address copied during install>
```
* On Kubernetes port-forward vmclarity-gateway service:
```
kubectl port-forward -n vmclarity service/vmclarity-gateway 8080:80
```
2. Access VMClarity UI in the browser: http://localhost:8080/
3. Access the [API](api/openapi.yaml) via http://localhost:8080/api
For a detailed UI tour, please see [tour](TOUR.md).
For step-by-step guidance on how to deploy VMClarity across different environments, including AWS, Azure, GCP, and Docker, click on [this link](https://openclarity.io/docs/vmclarity/getting-started/) and choose your preferred provider for detailed deployment instructions.

# Overview

Expand Down
55 changes: 0 additions & 55 deletions TOUR.md

This file was deleted.

1 change: 0 additions & 1 deletion assets/vmclarity-arch-20230406.svg

This file was deleted.

1 change: 0 additions & 1 deletion assets/vmclarity-cf-basic.svg

This file was deleted.

Binary file removed assets/vmclarity-dashboard-data.png
Binary file not shown.
Binary file removed assets/vmclarity-scan-config-summary.png
Binary file not shown.
Binary file removed assets/vmclarity-scan-list.png
Binary file not shown.
Binary file removed assets/vmclarity-scan-setup-1.png
Binary file not shown.
Binary file removed assets/vmclarity-scan-setup-2.png
Binary file not shown.
Binary file removed assets/vmclarity-scan-setup-3.png
Binary file not shown.
Binary file removed assets/vmclarity-scan-setup-4.png
Binary file not shown.
Binary file removed assets/vmclarity-ui-1.png
Binary file not shown.
Binary file removed assets/vmclarity-ui-2.png
Binary file not shown.
61 changes: 0 additions & 61 deletions installation/aws/README.md

This file was deleted.

24 changes: 0 additions & 24 deletions installation/docker/README.md

This file was deleted.

30 changes: 0 additions & 30 deletions installation/gcp/dm/README.md

This file was deleted.

0 comments on commit 71a17d9

Please sign in to comment.