Skip to content

Commit

Permalink
docs: vertex steps
Browse files Browse the repository at this point in the history
  • Loading branch information
karl-cardenas-coding committed Jun 11, 2024
1 parent 1644d91 commit a6a2b4e
Showing 1 changed file with 72 additions and 7 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -238,23 +238,88 @@ If you are working in Vim, press `i` to enter insert mode in the text editor. Pr
```

19. If you have custom SSL certificates you want to apply to the image and pack registry, and the Spectro Cloud
Repository, copy the custom SSL certificates, in base64 PEM format, to the airgap support VM. The custom
certificates must be placed in the **/opt/spectro/ssl** folder. Include the following files:
Repository, copy the custom SSL certificates, in base64 PEM format, to the airgap support VM.

If you do not provide a custom SSL certificate, the airgap setup process will generate a self-signed certificate for
you.

Select the tab below for detailed instructions on how to update the SSL certificates for the Pack Registry and the
Spectro Cloud Repository.

<!-- prettier-ignore -->
<Tabs>
<TabItem label="Pack Registry" value="pack_registry">

:::warning

Three items you need to keep in mind when providing custom SSL certificates:

- The custom SSL certificates must be in base64 PEM format. If you have custom SSL certificates in a different
format, convert them to base64 PEM format before copying them to the support VM. The airgap setup process also
expects the files to be named **server.crt** and **server.key**.

- The custom certificate's Fully Qualified Domain Name (FQDN) must match the hostname or IP address you provide for
the airgap support VM. Otherwise, the airgap setup process will fail due to a certificate mismatch.
- The custom SSL certificates must have the following permissions bits set:
- **server.crt**: 644
- **server.key**: 600
:::
The custom certificates must be placed in the **/opt/spectro/ssl** folder. Include the following files:
- **server.crt**
- **server.key**
If you do not provide a custom SSL certificate, the airgap setup process will generate a self-signed certificate for
you.
You also need to update the permissions for the **/data/secret/cert/** directory. This folder is mounted to Harbor
during the airgap setup process and must have access to the custom SSL certificates. Use the following command to
ensure the permissions are set correctly.
```shell
chown -R 10000:10000 /data/secret/cert/*
```
</TabItem>
<!-- prettier-ignore -->
<TabItem label="Spectro Cloud Artifact Registry" value="scar_registry">
:::warning
The custom SSL certificates must be in base64 PEM format. If you have custom SSL certificates in a different format,
convert them to base64 PEM format before copying them to the support VM. The airgap setup process also expects the
files to be named **server.crt** and **server.key**.
Three items you need to keep in mind when providing custom SSL certificates:
- The custom SSL certificates must be in base64 PEM format. If you have custom SSL certificates in a different
format, convert them to base64 PEM format before copying them to the support VM. The airgap setup process also
expects the files to be named **server.crt** and **server.key**.
- The custom certificate's Fully Qualified Domain Name (FQDN) must match the hostname or IP address you provide for
the airgap support VM. Otherwise, the airgap setup process will fail due to a certificate mismatch.

- The custom SSL certificates must have the following permissions bits set:

- **server.crt**: 644
- **server.key**: 600

:::

The custom certificates must be placed in the **/opt/spectro/ssl** folder. Include the following files:

- **server.crt**
- **server.key**

Copy the custom SSL certificates to the **/usr/local/share/ca-certificates/** directory. Issue the following
commands to copy the custom SSL certificates to the directory.

```shell
cp /opt/spectro/ssl/server.crt /usr/local/share/ca-certificates/ && \
update-ca-certificates
```

</TabItem>

</Tabs>

20. Start the airgap initialization process by issuing the following command. The script requires the hostname or IP
address of the airgap support VM. Choose the preferred method for your environment. Be aware that the script will
generate a self-signed certificate for the value you provide.
Expand Down

0 comments on commit a6a2b4e

Please sign in to comment.