The k8s App Deployment Tool
Kubernetes (k8s) has emerged as the de facto container orchestration platform offering excellent abstraction over infrastructure. But app deployments and delivery mechanisms to k8s are still way too complex. Delivery tools should simplify things for a developer so that developers can focus on writing apps & building value. This is best achieved if all the complexity of deployment completely disappears!
HyScale is a starting point for how a simplified service spec can allow developers to easily deploy the various (micro-)services in their app to k8s without having to wade through k8s complexities and also without having to write or maintain hundreds of lines of manifest yamls.
Here is what you need to do:
HyScale offers a declarative spec for k8s abstraction using which k8s manifests & docker files are automatically generated, docker images are built & pushed to the target docker registry, and the manifests are deployed to the k8s cluster resulting in a URL.
Here is a glimpse of what HyScale does when you invoke it
To get started, install hyscale as per the below instructions & follow the tutorial to deploy your first app.
In order to deploy your service to k8s, you must have the following configurations and installations in place on your machine from which you wish to deploy your application.
- Docker 18.09.x or above. Your Linux user should be part of the docker group and
docker.sockshould be present at /var/run/docker.sock (Default location)
- Kubernetes authentication credentials kubeconfig file having the cluster token placed at $HOME/.kube/config
- Image registry credentials at $HOME/.docker/config.json . Make sure
config.jsonhas the latest auth creds by logging into the image registry using
docker loginprior to deployment.
Open your terminal and enter the following:
curl -sSL http://get.hyscale.io | bash
Verified on CentOS, Ubuntu and Debian Linux. Mac and Windows installer coming soon!
Deploying to k8s
Preparing your first service spec (hspec)
Here is a basic service spec for deploying tomcat (without any application). To get started with more options see the tutorial.
name: myservice image: registry: registry.hub.docker.com/library name: tomcat tag: 8.5.0-jre8 volumes: - name: tomcat-logs-dir path: /usr/local/tomcat/logs size: 1Gi storageClass: standard external: true ports: - port: 8080/tcp healthCheck: httpPath: /docs/images/tomcat.gif
Deploy the service
To deploy, invoke the hyscale deploy command:
hyscale deploy service -f `<myservice.hspec.yaml>` -n `<my-namespace>` -a `<my-app-name>`
To view the status of your deployment:
hyscale get service status -s `<myservice>` -n `<my-namespace>` -a `<my-app-name>`
To view logs:
hyscale get service logs -s `<myservice>` -n `<my-namespace>` -a `<my-app-name>`
For all possible commands, see the command reference.
If you wish to contribute, see the architecture & contributor documentation here.