Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

58 lines
2.8 KiB
Markdown
Raw Permalink Normal View History

---
title_tag: BYO-Infra Install | Self-Hosting Pulumi
2023-04-11 13:40:50 -07:00
meta_desc: Installer and installation instructions for deploying the self-hosted Pulumi Cloud on your own K8s, MySQL and S3-compatible infrastructure.
title: Bring-your-own infra
h1: Pulumi Cloud self-hosted BYO-infra install
2023-06-08 16:15:52 -07:00
meta_image: /images/docs/meta-images/docs-meta.png
menu:
pulumicloud:
parent: deployment-options
weight: 7
aliases:
- /docs/guides/self-hosted/byo-infra-hosted/
---
2023-04-11 13:40:50 -07:00
The [BYO-Infrastructure Installer](https://github.com/pulumi/pulumi-self-hosted-installers/tree/master/byo-infra) installer is used to deploy the self-hosted Pulumi Cloud on your own K8s, MySQL and S3-compatible infrastructure.
## BYO-Infra Deployment
The BYO infrastructure installer uses Pulumi to deploy the following services on your infrastructure:
* Ingress Controller
* Pulumi API and Console applications
Prerequisites and configuration for the your infrastructure can be found in the [BYO-Infrastructure Installer README](https://github.com/pulumi/pulumi-self-hosted-installers/tree/master/byo-infra/README.md)
### Pulumi deploying Pulumi
2023-04-11 13:40:50 -07:00
This installer uses Pulumi to deploy the Pulumi Cloud. In this case, one uses the Pulumi CLI with a self-managed backend (e.g. S3 storage bucket) to deploy all services listed above to stand up the self-hosted Pulumi Cloud. The installation package includes Pulumi project code so that you can deploy the Service by running `pulumi up`.
To this end, you need to set up the following:
* [Download and install the Pulumi CLI](/docs/install/) on your workstation
* [Choose a self-managed storage backend](/docs/concepts/state/)
### Deployment Steps
See the [README](https://github.com/pulumi/pulumi-self-hosted-installers/tree/master/byo-infra/README.md) file provided with the installer package for detailed deployment steps.
## BYO Infrastructure Hosted System Management and Maintenance
2023-04-11 13:40:50 -07:00
### Pulumi Cloud Updates
2023-04-11 13:40:50 -07:00
When deploying the Pulumi Cloud, it is recommended to pin the image tag to a specific version. See the [installer's README](https://github.com/pulumi/pulumi-self-hosted-installers/tree/master/byo-infra/README.md) file to set the `imageTag` configuration property for the installer to use.
When ready to update the Pulumi Sevice containers to use a different version, do the following:
* `pulumi login` to the self-managed (not self-hosted) backend as chosen above when installing the self-hosted service.
* `pulumi config set imageTag {image tag}` to set the version you want to use.
* `pulumi up` to deploy the updates.
### Database Maintenance
It is highly recommended to deploy your MySQL server in a redundant configuration with checkpoints or at least periodic backups enabled.
### Bucket Maintenance
It is highly recommended to enable automatic backups for your S3-compatible storage buckets.