Skip to content

Commit

Permalink
docs: refactor and condensed pages
Browse files Browse the repository at this point in the history
  • Loading branch information
karl-cardenas-coding committed Sep 27, 2023
1 parent 2b5df86 commit bd49ded
Show file tree
Hide file tree
Showing 17 changed files with 296 additions and 58 deletions.
2 changes: 1 addition & 1 deletion docs/docs-content/clusters/public-cloud/azure/gateways.md
Original file line number Diff line number Diff line change
Expand Up @@ -171,7 +171,7 @@ After getting connected to the Bastion host, establish a connection to the Targe
kubectl apply -n cluster-1234abcd -f https://endpoint/v1/pcg/12345678901234/services/ally/manifest
```

6. The self-hosted PCG will be provisioned and will start running in the Palette console. The healthy self-hosted PCG can be managed from the Palette UI page. The healthy self-hosted PCG can be linked to Azure Cloud Account (optionally) to enjoy the enhanced security benefits. We support the [PCG migration](../../../enterprise-version/enterprise-cluster-management.md#palette-pcg-migration) for the public cloud self-hosted PCGs as well.
6. The self-hosted PCG will be provisioned and will start running in the Palette console. The healthy self-hosted PCG can be managed from the Palette UI page. The healthy self-hosted PCG can be linked to Azure Cloud Account (optionally) to enjoy the enhanced security benefits. We support the [PCG migration](../../../enterprise-version/system-management/system-management.md) for the public cloud self-hosted PCGs as well.

:::info

Expand Down
6 changes: 5 additions & 1 deletion docs/docs-content/enterprise-version/enterprise-version.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,4 +36,8 @@ Our dedicated support team will promptly get in touch with you to provide the ne
## Resources


- [Installation](install-palette/install-palette.md)
- [Installation](install-palette/install-palette.md)

- [System Management](system-management/system-management.md)

- [Upgrade Notes](upgrade.md)
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: "Install in an Air Gap Environment"
description: "Learn how to install Palette into a Kubernetes air gap environment."
icon: ""
hide_table_of_contents: false
sidebar_position: 70
sidebar_position: 20
tags: ["self-hosted", "enterprise", "air-gap"]
---

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,4 +18,7 @@ To get started with Palette on Kubernetes, refer to the [Install Instructions](i
- [Install Instructions](install.md)


- [Airgap Install Instructions](airgap-instructions.md)


- [Helm Configuration Reference](palette-helm-ref.md)
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
sidebar_label: "Install using Helm Chart"
title: "Install using Helm Chart"
sidebar_label: "Instructions"
title: "Instructions"
description: "Learn how to deploy self-hosted Palette to a Kubernetes cluster using a Helm Chart."
icon: ""
hide_table_of_contents: false
sidebar_position: 30
sidebar_position: 10
tags: ["self-hosted", "enterprise"]
---

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: "Helm Chart Install References"
description: "Reference for Palette Helm Chart installation parameters."
icon: ""
hide_table_of_contents: false
sidebar_position: 40
sidebar_position: 30
tags: ["self-hosted", "enterprise"]
---

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: "Install in an Air Gap Environment"
description: "Learn how to install Palette into an air gap environment."
icon: ""
hide_table_of_contents: false
sidebar_position: 70
sidebar_position: 20
tags: ["self-hosted", "enterprise", "air-gap"]
---

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,5 +17,8 @@ Palette can be installed on VMware vSphere with internet connectivity or an airg
- [Install on VMware](install.md)


- [Airgap Install Instructions](airgap-instructions.md)


- [VMware System Requirements](vmware-system-requirements.md)

Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: "VMware System and Permission Requirements"
description: "Review VMware system requirements and cloud account permissions."
icon: ""
hide_table_of_contents: false
sidebar_position: 20
sidebar_position: 30
tags: ["palette", "self-hosted", "vmware"]
---

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,36 +10,16 @@ tags: ["palette", "self-hosted"]

Palette is available as a self-hosted application that you install in your environment. The self-hosted version is a dedicated Palette environment hosted on VMware instances or in an existing Kubernetes cluster. Palette is available in the following modes:

| **Supported Platform** | **Description** |
|------------------------|------------------------------------|
| VMware | Install Palette in VMware environment. |
| Kubernetes | Install Palette using a Helm Chart in an existing Kubernetes cluster. |
| **Supported Platform** | **Description** | **Install Guide** |
|------------------------|------------------------------------| ------------------|
| VMware | Install Palette in VMware environment. | [Install on VMware](install-on-vmware/install-on-vmware.md) |
| Kubernetes | Install Palette using a Helm Chart in an existing Kubernetes cluster. | [Install on Kubernetes](install-on-kubernetes/install.md) |

The next sections describe specific requirements for installing Palette.

## Proxy Requirements

- A proxy used for outgoing connections should support both HTTP and HTTPS traffic.


- Allow connectivity to domains and ports in the table.

<br />
The next sections provide sizing guidelines we recommend you review before installing Palette in your environment.

| **Top-Level Domain** | **Port** | **Description** |
|----------------------------|----------|-------------------------------------------------|
| spectrocloud.com | 443 | Spectro Cloud content repository and pack registry |
| s3.amazonaws.com | 443 | Spectro Cloud VMware OVA files |
| gcr.io | 443 | Spectro Cloud and common third party container images |
| ghcr.io | 443 | Kubernetes VIP images |
| docker.io | 443 | Common third party content |
| googleapis.com | 443 | For pulling Spectro Cloud images |
| docker.com | 443 | Common third party container images |
| raw.githubusercontent.com | 443 | Common third party content |
| projectcalico.org | 443 | Calico container images |
| quay.io | 443 | Common 3rd party container images |
| grafana.com | 443 | Grafana container images and manifests |
| github.com | 443 | Common third party content |


## Size Guidelines
Expand Down Expand Up @@ -76,4 +56,34 @@ The recommended maximum number of deployed nodes and clusters in the environment



## Proxy Requirements

- A proxy used for outgoing connections should support both HTTP and HTTPS traffic.


- Allow connectivity to domains and ports in the table.

<br />

| **Top-Level Domain** | **Port** | **Description** |
|----------------------------|----------|-------------------------------------------------|
| spectrocloud.com | 443 | Spectro Cloud content repository and pack registry |
| s3.amazonaws.com | 443 | Spectro Cloud VMware OVA files |
| gcr.io | 443 | Spectro Cloud and common third party container images |
| ghcr.io | 443 | Kubernetes VIP images |
| docker.io | 443 | Common third party content |
| googleapis.com | 443 | For pulling Spectro Cloud images |
| docker.com | 443 | Common third party container images |
| raw.githubusercontent.com | 443 | Common third party content |
| projectcalico.org | 443 | Calico container images |
| quay.io | 443 | Common 3rd party container images |
| grafana.com | 443 | Grafana container images and manifests |
| github.com | 443 | Common third party content |

## Resources

- [Install on VMware](install-on-vmware/install-on-vmware.md)

- [Install on Kubernetes](install-on-kubernetes/install.md)

- [Architecture Diagram and Network Ports](../../architecture/networking-ports.md#self-hosted-network-communications-and-ports)
Original file line number Diff line number Diff line change
@@ -0,0 +1,146 @@
---
sidebar_label: "Backup and Restore"
title: "Backup and Restore"
description: "Learn how to enable backup and restore for self-hosted Palette."
icon: ""
hide_table_of_contents: false
sidebar_position: 50
tags: ["palette", "management", "self-hosted", "backup", "restore"]
---

You can enable backup and restore for your self-hosted Palette cluster to ensure that your Palete configuration data is backed up and can be restored in case of a disaster or a cluster failure. Palette supports two modes of backup:

* File Transfer Protocol (FTP) - Send the backup data of your enterprise cluster to a dedicated FTP server. Refer to the [FTP](#ftp) section for more information.


* Amazon Simple Storage Service (S3) - Send the backup data of your enterprise cluster to object storage using the AWS service S3. Refer to the [S3](#s3) section for more information.


## FTP

Use the following instructions to configure FTP backup for your enterprise cluster.

### Prerequisites

* A dedicated FTP server with sufficient storage space to store the backup data.


* Credentials to access the FTP server.


### Instructions

1. Log into the Palette system console as an administrator. Refer to the [Access the System Console](../system-management/system-management.md#access-the-system-console) section for more information.


2. From the left **Main Menu**, select **Administration**.


3. Click on the **Backup/Restore** tab.


4. Select the **FTP** and fill out the following fields:

| **Field** | **Description** |
| --- | --- |
| Server | The FTP server URL. |
| Directory | The directory name for the backup storage. |
| Username | The username to log in to the FTP server. |
| Password | The password to log in to the FTP server. |
| Interval | The number of days between backups. |
| Retention Period | The number of days to retain the backup. |
| Hours of the day | The time of the day to take the backup. The time of day is in UTC format. |


5. Click on **Validate** to validate the FTP server configuration. If the validation is successful, the **Save** button is enabled. Otherwise, an error message is displayed. In case of an error, correct verify the FTP server configuration and click on **Validate** again.


### Validate

Validation is part of the backup configuration wizard. You can validate a backup is initiated at the scheduled time and that the backup is successfully uploaded to the FTP server.


## S3

Use the following instructions to configure S3 backup for your enterprise cluster.



### Prerequisites

- An Amazon Web Services (AWS) account.

- An AWS S3 bucket.

- An AWS IAM user with the following IAM permissions attached. Ensure you replace the bucket name in the `Resource` field with the name of your S3 bucket.

```json
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "s3Permissions",
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:DeleteObject",
"s3:PutObject",
"s3:AbortMultipartUpload",
"s3:ListMultipartUploadParts"
],
"Resource": [
"arn:aws:s3:::REPLACE_ME_WITH_YOUR_BUCKET_NAME",
"arn:aws:s3:::REPLACE_ME_WITH_YOUR_BUCKET_NAME/*"
]
},
{
"Sid": "ec2Permissions",
"Effect": "Allow",
"Action": [
"ec2:DescribeVolumes",
"ec2:DescribeSnapshots",
"ec2:CreateTags",
"ec2:CreateVolume",
"ec2:CreateSnapshot",
"ec2:DeleteSnapshot"
],
"Resource": [
"*"
]
}
]
}
```

- Credentials to the IAM user. You need the AWS access key ID and the AWS secret access key.


### Instructions

1. Log into the Palette system console as an administrator. Refer to the [Access the System Console](../system-management/system-management.md#access-the-system-console) section for more information.


2. From the left **Main Menu**, select **Administration**.


3. Click on the **Backup/Restore** tab.


4. Select the **FTP** and fill out the following fields:

| **Field** | **Description** |
| --- | --- |
| Server | The FTP server URL. |
| Directory | The directory name for the backup storage. |
| Username | The username to log in to the FTP server. |
| Password | The password to log in to the FTP server. |
| Interval | The number of days between backups. |
| Retention Period | The number of days to retain the backup. |
| Hours of the day | The time of the day to take the backup. The time of day is in UTC format. |


5. Click on **Validate** to validate the S3 configuration. If the validation is successful, the **Save** button is enabled. Otherwise, an error message is displayed. In case of an error, correct verify the S3 configuration and click on **Validate** again.

### Validate

Validation is part of the backup configuration wizard. You can validate a backup is initiated at the scheduled time and that the backup is successfully uploaded to the S3 bucket.
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,6 @@ tags: ["palette", "self-hosted", "management"]

Palette contains many system settings you can configure to meet your organization's needs. These settings are available at the system level and are applied to all [tenants](../../glossary-all.md#tenant) in the system.

You can access the system setting by visiting the IP address or the custom domain name assigned to your Palette cluster and appending the `/system` path to the URL. For example, if your Palette cluster is hosted at `https://palette.abc.com`, you can access the system settings at `https://palette.abc.com/system`.



:::caution
Expand All @@ -21,10 +19,51 @@ Exercise caution when changing system settings as the changes will be applied to
:::



## System Console

The system console enables you to complete the initial setup and onboarding and manage the overall Palette environment.

### Access the System Console

You can access the system console by visiting the IP address or the custom domain name assigned to your Palette cluster and appending the `/system` path to the URL. For example, if your Palette cluster is hosted at `https://palette.abc.com`, you can access the system console at `https://palette.abc.com/system`.


## Administration and Management

Platform administrators can use this console to perform the following operations:

- Configure and manage SMTP settings.

- Configure and manage Pack registries.

- [Configure and manage SSL certificates](ssl-certificate-management.md).

- [Enable backup and restore](backup-restore.md).

- Configure DNS settings.

- Setup alerts and notifications.

- Enable metrics collection.

- Manage Palette platform upgrades.

- Configuere login banner.

- [Manage tenants](tenant-management.md).

- Manage the Enterprise cluster and the profile layers and pack integrations that makeup the Enterprise cluster.

Check out the following resources to learn more about these operations.

## Resources


* [Tenant Management](../system-management/tenant-management.md)
* [Tenant Management](tenant-management.md)


* [Configure Reverse Proxy](reverse-proxy.md)


* [SSL Certificate Management](../system-management/ssl-certificate-management.md)
* [SSL Certificate Management](ssl-certificate-management.md)
2 changes: 1 addition & 1 deletion docs/docs-content/palette-cli/commands.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ Palette CLI supports the following global flags.

## EC

The `ec` subcommand installs a self-hosted Palette Enterprise Cluster (EC) in your target environment. The installation is conducted through an interactive wizard that guides you through the various install configurations available. A local kind cluster is created to facilitate creating the Enterprise cluster in the target environment. You do not need to install kind or any other dependencies. The CLI includes all the required dependencies to stand up the kind cluster. You can use the `ec` command to install a [self-hosted Palette](../enterprise-version/deploying-an-enterprise-cluster.md) instance or a self-hosted [VerteX](../vertex/install-palette-vertex/install-palette-vertex.md) instance.
The `ec` subcommand installs a self-hosted Palette Enterprise Cluster (EC) in your target environment. The installation is conducted through an interactive wizard that guides you through the various install configurations available. A local kind cluster is created to facilitate creating the Enterprise cluster in the target environment. You do not need to install kind or any other dependencies. The CLI includes all the required dependencies to stand up the kind cluster. You can use the `ec` command to install a [self-hosted Palette](../enterprise-version/install-palette/install-palette.md) instance or a self-hosted [VerteX](../vertex/install-palette-vertex/install-palette-vertex.md) instance.

The `ec` subcommand exposes the following subcommand.

Expand Down
Loading

0 comments on commit bd49ded

Please sign in to comment.