mirror of https://github.com/helm/helm
jackgr
9 years ago
parent
1b0bb08207
commit
b6b5c42866
@ -0,0 +1,67 @@
|
||||
# Bootstrapping Deployment Manager
|
||||
|
||||
Welcome to the bootstrap example. The instructions below will step you through
|
||||
the process of building and running a local instance of Deployment Manager on
|
||||
your local machine, and then using it to deploy another instance in your cluster.
|
||||
|
||||
This example provides insights into how Deployment Manager works, and is
|
||||
recommended for anyone interested in contributing to the project.
|
||||
|
||||
The instructions below assume that you have a Kubernetes cluster up and running,
|
||||
and that you can run `kubectl` commands against it. They also assume that that
|
||||
you're working with a clone of the repository installed in the src folder of your
|
||||
GOPATH and that your PATH contains `$GOPATH/bin`, per convention.
|
||||
|
||||
## Installing required python packages
|
||||
|
||||
Since Deployment Manager uses Python and will be running locally on your
|
||||
machine, you will first need to make sure the necessary Python packages are
|
||||
installed. This assumes that you have already installed the pip package
|
||||
management system on your machine.
|
||||
|
||||
```
|
||||
sudo pip install -r expandybird/requirements.txt
|
||||
```
|
||||
|
||||
## Building and installing the binaries
|
||||
|
||||
Next, you're going to build and install the Deployment Manager binaries. You can
|
||||
do this by running make in the repository root.
|
||||
|
||||
```
|
||||
make
|
||||
```
|
||||
|
||||
## Bootstrapping Deployment Manager
|
||||
|
||||
Now, you're ready to bootstrap Deployment Manager into the cluster.
|
||||
|
||||
### Start Deployment Manager on localhost
|
||||
|
||||
First, start the three Deployment Manager binaries on localhost using the supplied
|
||||
bootstrap script.
|
||||
|
||||
```
|
||||
./examples/bootstrap/bootstrap.sh
|
||||
```
|
||||
|
||||
The script starts the following binaries:
|
||||
* manager (frontend service) running on port 8080
|
||||
* expandybird (expands templates) running on port 8081
|
||||
* resourcifier (reifies primitive Kubernetes resources) running on port 8082
|
||||
|
||||
It also starts kubectl proxy on port 8001.
|
||||
|
||||
### Deploy Deployment Manager into your cluster
|
||||
|
||||
Next, use the Deployment Manager running on localhost to deploy itself onto the
|
||||
cluster using the supplied command line tool and template.
|
||||
|
||||
```
|
||||
client --name test --service=http://localhost:8080 examples/bootstrap/bootstrap.yaml
|
||||
```
|
||||
|
||||
You should now have Deployment Manager running on your cluster, and it should be
|
||||
visible using kubectl (kubectl get pod,rc,service).
|
||||
|
||||
|
||||
@ -0,0 +1,145 @@
|
||||
######################################################################
|
||||
# Copyright 2015 The Kubernetes Authors All rights reserved.
|
||||
# Licensed under the Apache License, Version 2.0 (the "License");
|
||||
# you may not use this file except in compliance with the License.
|
||||
# You may obtain a copy of the License at
|
||||
# http://www.apache.org/licenses/LICENSE-2.0
|
||||
# Unless required by applicable law or agreed to in writing, software
|
||||
# distributed under the License is distributed on an "AS IS" BASIS,
|
||||
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
# See the License for the specific language governing permissions and
|
||||
# limitations under the License.
|
||||
######################################################################
|
||||
|
||||
---
|
||||
apiVersion: v1
|
||||
kind: Service
|
||||
metadata:
|
||||
labels:
|
||||
app: dm
|
||||
name: expandybird-service
|
||||
name: expandybird-service
|
||||
namespace: default
|
||||
spec:
|
||||
ports:
|
||||
- name: expandybird
|
||||
port: 8081
|
||||
targetPort: 8080
|
||||
selector:
|
||||
app: dm
|
||||
name: expandybird
|
||||
---
|
||||
apiVersion: v1
|
||||
kind: ReplicationController
|
||||
metadata:
|
||||
labels:
|
||||
app: dm
|
||||
name: expandybird-rc
|
||||
name: expandybird-rc
|
||||
namespace: default
|
||||
spec:
|
||||
replicas: 2
|
||||
selector:
|
||||
app: dm
|
||||
name: expandybird
|
||||
template:
|
||||
metadata:
|
||||
labels:
|
||||
app: dm
|
||||
name: expandybird
|
||||
spec:
|
||||
containers:
|
||||
- env: []
|
||||
image: gcr.io/dm-k8s-testing/expandybird:latest
|
||||
name: expandybird
|
||||
ports:
|
||||
- containerPort: 8080
|
||||
name: expandybird
|
||||
---
|
||||
apiVersion: v1
|
||||
kind: Service
|
||||
metadata:
|
||||
labels:
|
||||
app: dm
|
||||
name: resourcifier-service
|
||||
name: resourcifier-service
|
||||
namespace: default
|
||||
spec:
|
||||
ports:
|
||||
- name: resourcifier
|
||||
port: 8082
|
||||
targetPort: 8080
|
||||
selector:
|
||||
app: dm
|
||||
name: resourcifier
|
||||
---
|
||||
apiVersion: v1
|
||||
kind: ReplicationController
|
||||
metadata:
|
||||
labels:
|
||||
app: dm
|
||||
name: resourcifier-rc
|
||||
name: resourcifier-rc
|
||||
namespace: default
|
||||
spec:
|
||||
replicas: 2
|
||||
selector:
|
||||
app: dm
|
||||
name: resourcifier
|
||||
template:
|
||||
metadata:
|
||||
labels:
|
||||
app: dm
|
||||
name: resourcifier
|
||||
spec:
|
||||
containers:
|
||||
- env: []
|
||||
image: gcr.io/dm-k8s-testing/resourcifier:latest
|
||||
name: resourcifier
|
||||
ports:
|
||||
- containerPort: 8080
|
||||
name: resourcifier
|
||||
---
|
||||
apiVersion: v1
|
||||
kind: Service
|
||||
metadata:
|
||||
labels:
|
||||
app: dm
|
||||
name: manager-service
|
||||
name: manager-service
|
||||
namespace: default
|
||||
spec:
|
||||
ports:
|
||||
- name: manager
|
||||
port: 8080
|
||||
targetPort: 8080
|
||||
selector:
|
||||
app: dm
|
||||
name: manager
|
||||
---
|
||||
apiVersion: v1
|
||||
kind: ReplicationController
|
||||
metadata:
|
||||
labels:
|
||||
app: dm
|
||||
name: manager-rc
|
||||
name: manager-rc
|
||||
namespace: default
|
||||
spec:
|
||||
replicas: 1
|
||||
selector:
|
||||
app: dm
|
||||
name: manager
|
||||
template:
|
||||
metadata:
|
||||
labels:
|
||||
app: dm
|
||||
name: manager
|
||||
spec:
|
||||
containers:
|
||||
- env: []
|
||||
image: gcr.io/dm-k8s-testing/manager:latest
|
||||
name: manager
|
||||
ports:
|
||||
- containerPort: 8080
|
||||
name: manager
|
||||
Loading…
Reference in new issue