@@ -22,30 +22,9 @@ The screen will refresh and show a progress meter. A typical launch will take ab | |||||
The very first Bubble you launch will use a [packer image](packer.md) that was created | The very first Bubble you launch will use a [packer image](packer.md) that was created | ||||
during [activation](activation.md). | during [activation](activation.md). | ||||
### Packer Image Creation | |||||
Normally the packer images are created during activation, and are generally available within about 20 minutes. | |||||
If the required packer image is still being built when you launch your first Bubble, it's OK, | |||||
the launcher will wait for the packer image to be ready. | |||||
If for some reason the packer image does not exist and is not currently being built, | |||||
then the launcher will start building the packer image right then. | |||||
This process adds about 20 minutes to the launch process. | |||||
When launching a Bubble and the required packer image is still being built, | |||||
the progress meter will appear to be "stuck" at 1% until the image is ready. This is normal. | |||||
If you're running the launcher from a [binary](run-binary.md) or [source](dev.md) Bubble distribution, | |||||
you can check the status of the packer jobs by running | |||||
```shell script | |||||
pack_status | |||||
``` | |||||
If you're running the launcher from using the [Bubble Docker Launcher](docker-launcher.md), | |||||
you can observe output of the packer image being built in your Bubble logs. | |||||
More details on packer and the `pack_status` command are available in | |||||
the [Bubble packer documentation](packer.md). | |||||
If the image is still being built or needs to be built, that will add some time to the launch process. | |||||
The [Bubble packer documentation](packer.md) has more details on this process. | |||||
## Install Bubble Apps | ## Install Bubble Apps | ||||
While your Bubble is launching, take a moment to | While your Bubble is launching, take a moment to | ||||
@@ -21,16 +21,12 @@ Choose your configuration options, then click the "Launch Your Bubble!" button k | |||||
The screen will refresh and show a progress meter. A typical launch will take about 10 minutes. | The screen will refresh and show a progress meter. A typical launch will take about 10 minutes. | ||||
## Your Very First Bubble | ## Your Very First Bubble | ||||
The very first Bubble you launch will build a [Packer](https://packer.io) image that will be used for this and | |||||
subsequent launches. | |||||
The very first Bubble you launch will use a [packer image](packer.md) that was created | |||||
during [activation](activation.md). | |||||
This process adds about 20-25 minutes to the launch process. | |||||
If the image is still being built or needs to be built, that will add some time to the launch process. | |||||
While the packer image is building, the progress meter will appear to be "stuck" at 1%. This is normal. | |||||
If you're curious, you can observe the packer image being built in your Bubble logs. | |||||
This only happens the first time you launch a Bubble. | |||||
Later launches can skip this step, because Bubble will detect that the packer image already exists. | |||||
The [Bubble packer documentation](packer.md) has more details on this process. | |||||
## Install Bubble Apps | ## Install Bubble Apps | ||||
While your Bubble is launching, take a moment to | While your Bubble is launching, take a moment to | ||||
@@ -23,13 +23,18 @@ A `node` image is for deploying new Bubbles in Node mode. A regular Bubble that | |||||
Bubble will automatically use the appropriate image type based on the Launch Type. | Bubble will automatically use the appropriate image type based on the Launch Type. | ||||
To set the Launch Type: on the Bubble launch screen, click the "Launch with Advanced Settings" link. | |||||
### Setting the Launch Type | |||||
#### Via Web UI | |||||
On the Bubble launch screen, click the "Launch with Advanced Settings" link. | |||||
The first drop-down option is "Bubble Type". | |||||
When using the API, set the `launchType` property in the JSON request that creates the Bubble. | |||||
#### Via the API | |||||
When using the API, set the `launchType` property in the JSON object that creates the Bubble. | |||||
## Launching a Bubble while Packer Images are Building | ## Launching a Bubble while Packer Images are Building | ||||
If you try to launch a Bubble before the required packer image is ready, your Bubble launcher will detect that the image | |||||
is in the process of being built, and wait until it is ready before trying to use it. | |||||
If you try to launch a Bubble before the required packer image is ready, | |||||
your Bubble launcher will detect that the image is in the process of being built, | |||||
and wait until it is ready before trying to use it. | |||||
## Image Validity | ## Image Validity | ||||
The packer images are tied to a specific Bubble version. As long as the Bubble API launcher can find packer images | The packer images are tied to a specific Bubble version. As long as the Bubble API launcher can find packer images | ||||
@@ -30,16 +30,12 @@ Configure the remaining fields as you desire. When you're ready, click the "Laun | |||||
The screen will refresh and show a progress meter. A typical launch will take about 10 minutes. | The screen will refresh and show a progress meter. A typical launch will take about 10 minutes. | ||||
## Your Very Remote Launcher | ## Your Very Remote Launcher | ||||
The very first Remote Launcher you launch will build a [Packer](https://packer.io) image that will be used for this and | |||||
subsequent launches. | |||||
The very first Bubble Remote Launcher you launch will use a [packer image](packer.md) that was created | |||||
during [activation](activation.md). | |||||
This process adds about 20-25 minutes to the launch process. | |||||
If the image is still being built or needs to be built, that will add some time to the launch process. | |||||
While the packer image is building, the progress meter will appear to be "stuck" at 1%. This is normal. | |||||
If you're curious, you can observe the packer image being built in your Bubble logs. | |||||
This only happens the first time you launch a Remote Launcher. | |||||
Later launches can skip this step, because Bubble will detect that the packer image already exists. | |||||
The [Bubble packer documentation](packer.md) has more details on this process. | |||||
## Next Steps | ## Next Steps | ||||
When your Bubble finishes launching, it will show a "Connect to Bubble" button. Click this and you'll be connected | When your Bubble finishes launching, it will show a "Connect to Bubble" button. Click this and you'll be connected | ||||