Part 3 Of A Series
This is part 3 of a guide that walks through creating a sample application in Replicated Ship. If you haven’t followed the previous sections of this guide, go back to deploying an application before following this guide.
Installing the Release
Now we can produce an installation script for our test customer.
Installing Ship
This guide assumes you’ll run Ship with Homebrew using
brew install ship, or downloading the binary, but you can also run Ship with the replicated/ship docker container.
Copy the command from this screen, and take it to a workstation that has [ship installed](), and run it. This is how you can distribute software that’s packaged in Ship.
Run the command
ship init "replicated.app/init?customer_id=0WPn1Ng6xxxxxxxxxxxxxjpUW&installation_id=Oa4adGM5q3e24super-secretf3BQd"
This command will read the release we created in https://console.replicated.com and then prompt us to open a browser:
Reading replicated.app/init?customer_id=0WPn1Ng6dfxxxxxxxxxx4ENWfxjpUW&installation_id=Oa4adGM5q3e2super-secretBQd ...
Determining application type ...
Detected application type replicated.app
Please visit the following URL in your browser to continue the installation
http://localhost:8800
From here, you’ll work through the lifecycle we defined previously, until you get to the “You’re all done” page:
Review Outputs
Once you reach the end of the workflow, the ship init CLI command will exit, and you can review the files creeated:
$ find .
.
./.ship
./.ship/state.json
./installer
./installer/k8s
./installer/k8s/nginx-service.yaml
./installer/k8s/nginx-deployment.yaml
Our inline assets from above have been created under the installer directory. There’s also a .ship/state.json which holds metadata about the installation. We’ll use this state file later in the Shipping an Update chapter of this guide.
Installing to a cluster
Executing this installer script generated everything that’s needed to deploy our application to a Kubernetes cluster. But we need to bring a Kubernetes cluster, and should already have kubectl set up and configured to continue with the next steps.
Deploy resources
As instructed in the lifeycle, we can
kubectl apply -f installer/k8s
and we’re off to the races. If you’re on Docker for Desktop, the LoadBalancer service should get your nginx listening on port 80 on localhost. If you’re on a cloud-provided cluster, you’ll need to inspect kubectl get svc to find the load balancer IP.
Next Steps
Now that we’ve shipped our first release, its time to work through Shipping an Update.