mirror of https://github.com/helm/helm
Adam Reese
9 years ago
parent
bddebc9428
commit
9550aefd73
@ -1,9 +0,0 @@
|
|||||||
The testdata directory here holds charts that match the specification.
|
|
||||||
|
|
||||||
The `fromnitz/` directory contains a chart that matches the chart
|
|
||||||
specification.
|
|
||||||
|
|
||||||
The `frobnitz-0.0.1.tgz` file is an archive of the `frobnitz` directory.
|
|
||||||
|
|
||||||
The `ill` chart and directory is a chart that is not 100% compatible,
|
|
||||||
but which should still be parseable.
|
|
||||||
Binary file not shown.
@ -1,27 +0,0 @@
|
|||||||
name: frobnitz
|
|
||||||
description: This is a frobniz.
|
|
||||||
version: 1.2.3-alpha.1+12345
|
|
||||||
keywords:
|
|
||||||
- frobnitz
|
|
||||||
- sprocket
|
|
||||||
- dodad
|
|
||||||
maintainers:
|
|
||||||
- name: The Helm Team
|
|
||||||
email: helm@example.com
|
|
||||||
- name: Someone Else
|
|
||||||
email: nobody@example.com
|
|
||||||
source:
|
|
||||||
- https://example.com/foo/bar
|
|
||||||
home: http://example.com
|
|
||||||
dependencies:
|
|
||||||
- name: thingerbob
|
|
||||||
version: ^3
|
|
||||||
location: https://example.com/charts/thingerbob-3.2.1.tgz
|
|
||||||
environment:
|
|
||||||
- name: Kubernetes
|
|
||||||
version: ~1.1
|
|
||||||
extensions:
|
|
||||||
- extensions/v1beta1
|
|
||||||
- extensions/v1beta1/daemonset
|
|
||||||
apiGroups:
|
|
||||||
- 3rdParty
|
|
||||||
@ -1 +0,0 @@
|
|||||||
THIS IS PLACEHOLDER TEXT.
|
|
||||||
@ -1,11 +0,0 @@
|
|||||||
# Frobnitz
|
|
||||||
|
|
||||||
This is an example chart.
|
|
||||||
|
|
||||||
## Usage
|
|
||||||
|
|
||||||
This is an example. It has no usage.
|
|
||||||
|
|
||||||
## Development
|
|
||||||
|
|
||||||
For developer info, see the top-level repository.
|
|
||||||
@ -1 +0,0 @@
|
|||||||
This is a placeholder for documentation.
|
|
||||||
@ -1 +0,0 @@
|
|||||||
# Placeholder.
|
|
||||||
|
Before Width: | Height: | Size: 374 B |
@ -1,12 +0,0 @@
|
|||||||
# Google Cloud Deployment Manager template
|
|
||||||
resources:
|
|
||||||
- name: nfs-disk
|
|
||||||
type: compute.v1.disk
|
|
||||||
properties:
|
|
||||||
zone: us-central1-b
|
|
||||||
sizeGb: 200
|
|
||||||
- name: mysql-disk
|
|
||||||
type: compute.v1.disk
|
|
||||||
properties:
|
|
||||||
zone: us-central1-b
|
|
||||||
sizeGb: 200
|
|
||||||
@ -1,72 +0,0 @@
|
|||||||
#helm:generate dm_template
|
|
||||||
{% set PROPERTIES = properties or {} %}
|
|
||||||
{% set PROJECT = PROPERTIES['project'] or 'dm-k8s-testing' %}
|
|
||||||
{% set NFS_SERVER = PROPERTIES['nfs-server'] or {} %}
|
|
||||||
{% set NFS_SERVER_IP = NFS_SERVER['ip'] or '10.0.253.247' %}
|
|
||||||
{% set NFS_SERVER_PORT = NFS_SERVER['port'] or 2049 %}
|
|
||||||
{% set NFS_SERVER_DISK = NFS_SERVER['disk'] or 'nfs-disk' %}
|
|
||||||
{% set NFS_SERVER_DISK_FSTYPE = NFS_SERVER['fstype'] or 'ext4' %}
|
|
||||||
{% set NGINX = PROPERTIES['nginx'] or {} %}
|
|
||||||
{% set NGINX_PORT = 80 %}
|
|
||||||
{% set NGINX_REPLICAS = NGINX['replicas'] or 2 %}
|
|
||||||
{% set WORDPRESS_PHP = PROPERTIES['wordpress-php'] or {} %}
|
|
||||||
{% set WORDPRESS_PHP_REPLICAS = WORDPRESS_PHP['replicas'] or 2 %}
|
|
||||||
{% set WORDPRESS_PHP_PORT = WORDPRESS_PHP['port'] or 9000 %}
|
|
||||||
{% set MYSQL = PROPERTIES['mysql'] or {} %}
|
|
||||||
{% set MYSQL_PORT = MYSQL['port'] or 3306 %}
|
|
||||||
{% set MYSQL_PASSWORD = MYSQL['password'] or 'mysql-password' %}
|
|
||||||
{% set MYSQL_DISK = MYSQL['disk'] or 'mysql-disk' %}
|
|
||||||
{% set MYSQL_DISK_FSTYPE = MYSQL['fstype'] or 'ext4' %}
|
|
||||||
|
|
||||||
resources:
|
|
||||||
- name: nfs
|
|
||||||
type: github.com/kubernetes/application-dm-templates/storage/nfs:v1
|
|
||||||
properties:
|
|
||||||
ip: {{ NFS_SERVER_IP }}
|
|
||||||
port: {{ NFS_SERVER_PORT }}
|
|
||||||
disk: {{ NFS_SERVER_DISK }}
|
|
||||||
fstype: {{NFS_SERVER_DISK_FSTYPE }}
|
|
||||||
- name: nginx
|
|
||||||
type: github.com/kubernetes/application-dm-templates/common/replicatedservice:v2
|
|
||||||
properties:
|
|
||||||
service_port: {{ NGINX_PORT }}
|
|
||||||
container_port: {{ NGINX_PORT }}
|
|
||||||
replicas: {{ NGINX_REPLICAS }}
|
|
||||||
external_service: true
|
|
||||||
image: gcr.io/{{ PROJECT }}/nginx:latest
|
|
||||||
volumes:
|
|
||||||
- mount_path: /var/www/html
|
|
||||||
persistentVolumeClaim:
|
|
||||||
claimName: nfs
|
|
||||||
- name: mysql
|
|
||||||
type: github.com/kubernetes/application-dm-templates/common/replicatedservice:v2
|
|
||||||
properties:
|
|
||||||
service_port: {{ MYSQL_PORT }}
|
|
||||||
container_port: {{ MYSQL_PORT }}
|
|
||||||
replicas: 1
|
|
||||||
image: mysql:5.6
|
|
||||||
env:
|
|
||||||
- name: MYSQL_ROOT_PASSWORD
|
|
||||||
value: {{ MYSQL_PASSWORD }}
|
|
||||||
volumes:
|
|
||||||
- mount_path: /var/lib/mysql
|
|
||||||
gcePersistentDisk:
|
|
||||||
pdName: {{ MYSQL_DISK }}
|
|
||||||
fsType: {{ MYSQL_DISK_FSTYPE }}
|
|
||||||
- name: wordpress-php
|
|
||||||
type: github.com/kubernetes/application-dm-templates/common/replicatedservice:v2
|
|
||||||
properties:
|
|
||||||
service_name: wordpress-php
|
|
||||||
service_port: {{ WORDPRESS_PHP_PORT }}
|
|
||||||
container_port: {{ WORDPRESS_PHP_PORT }}
|
|
||||||
replicas: 2
|
|
||||||
image: wordpress:fpm
|
|
||||||
env:
|
|
||||||
- name: WORDPRESS_DB_PASSWORD
|
|
||||||
value: {{ MYSQL_PASSWORD }}
|
|
||||||
- name: WORDPRESS_DB_HOST
|
|
||||||
value: mysql-service
|
|
||||||
volumes:
|
|
||||||
- mount_path: /var/www/html
|
|
||||||
persistentVolumeClaim:
|
|
||||||
claimName: nfs
|
|
||||||
@ -1,69 +0,0 @@
|
|||||||
info:
|
|
||||||
title: Wordpress
|
|
||||||
description: |
|
|
||||||
Defines a Wordpress website by defining four replicated services: an NFS service, an nginx service, a wordpress-php service, and a MySQL service.
|
|
||||||
|
|
||||||
The nginx service and the Wordpress-php service both use NFS to share files.
|
|
||||||
|
|
||||||
properties:
|
|
||||||
project:
|
|
||||||
type: string
|
|
||||||
default: dm-k8s-testing
|
|
||||||
description: Project location to load the images from.
|
|
||||||
nfs-service:
|
|
||||||
type: object
|
|
||||||
properties:
|
|
||||||
ip:
|
|
||||||
type: string
|
|
||||||
default: 10.0.253.247
|
|
||||||
description: The IP of the NFS service.
|
|
||||||
port:
|
|
||||||
type: int
|
|
||||||
default: 2049
|
|
||||||
description: The port of the NFS service.
|
|
||||||
disk:
|
|
||||||
type: string
|
|
||||||
default: nfs-disk
|
|
||||||
description: The name of the persistent disk the NFS service uses.
|
|
||||||
fstype:
|
|
||||||
type: string
|
|
||||||
default: ext4
|
|
||||||
description: The filesystem the disk of the NFS service uses.
|
|
||||||
nginx:
|
|
||||||
type: object
|
|
||||||
properties:
|
|
||||||
replicas:
|
|
||||||
type: int
|
|
||||||
default: 2
|
|
||||||
description: The number of replicas for the nginx service.
|
|
||||||
wordpress-php:
|
|
||||||
type: object
|
|
||||||
properties:
|
|
||||||
replicas:
|
|
||||||
type: int
|
|
||||||
default: 2
|
|
||||||
description: The number of replicas for the wordpress-php service.
|
|
||||||
port:
|
|
||||||
type: int
|
|
||||||
default: 9000
|
|
||||||
description: The port the wordpress-php service runs on.
|
|
||||||
mysql:
|
|
||||||
type: object
|
|
||||||
properties:
|
|
||||||
port:
|
|
||||||
type: int
|
|
||||||
default: 3306
|
|
||||||
description: The port the MySQL service runs on.
|
|
||||||
password:
|
|
||||||
type: string
|
|
||||||
default: mysql-password
|
|
||||||
description: The root password of the MySQL service.
|
|
||||||
disk:
|
|
||||||
type: string
|
|
||||||
default: mysql-disk
|
|
||||||
description: The name of the persistent disk the MySQL service uses.
|
|
||||||
fstype:
|
|
||||||
type: string
|
|
||||||
default: ext4
|
|
||||||
description: The filesystem the disk of the MySQL service uses.
|
|
||||||
|
|
||||||
@ -1,6 +0,0 @@
|
|||||||
imports:
|
|
||||||
- path: wordpress.jinja
|
|
||||||
|
|
||||||
resources:
|
|
||||||
- name: wordpress
|
|
||||||
type: wordpress.jinja
|
|
||||||
@ -1,127 +0,0 @@
|
|||||||
T**Testing fork of the guestbook example.**
|
|
||||||
|
|
||||||
# Guestbook Example
|
|
||||||
|
|
||||||
Welcome to the Guestbook example. It shows you how to build and reuse
|
|
||||||
parameterized templates.
|
|
||||||
|
|
||||||
## Prerequisites
|
|
||||||
|
|
||||||
First, make sure DM is installed in your Kubernetes cluster and that the
|
|
||||||
Guestbook example is deployed by following the instructions in the top level
|
|
||||||
[README.md](../../README.md).
|
|
||||||
|
|
||||||
## Understanding the Guestbook example
|
|
||||||
|
|
||||||
Let's take a closer look at the configuration used by the Guestbook example.
|
|
||||||
|
|
||||||
### Replicated services
|
|
||||||
|
|
||||||
The typical design pattern for microservices in Kubernetes is to create a
|
|
||||||
replication controller and a service with the same selector, so that the service
|
|
||||||
exposes ports from the pods managed by the replication controller.
|
|
||||||
|
|
||||||
We have created a parameterized template for this kind of replicated service
|
|
||||||
called [Replicated Service](../../templates/replicatedservice/v1), and we use it
|
|
||||||
three times in the Guestbook example.
|
|
||||||
|
|
||||||
The template is defined by a
|
|
||||||
[Python script](../../templates/replicatedservice/v1/replicatedservice.py). It
|
|
||||||
also has a [schema](../../templates/replicatedservice/v1/replicatedservice.py.schema).
|
|
||||||
Schemas are optional. If provided, they are used to validate template invocations
|
|
||||||
that appear in configurations.
|
|
||||||
|
|
||||||
For more information about templates and schemas, see the
|
|
||||||
[design document](../../docs/design/design.md#templates).
|
|
||||||
|
|
||||||
### The Guestbook application
|
|
||||||
The Guestbook application consists of 2 microservices: a front end and a Redis
|
|
||||||
cluster.
|
|
||||||
|
|
||||||
#### The front end
|
|
||||||
|
|
||||||
The front end is a replicated service with 3 replicas:
|
|
||||||
|
|
||||||
```
|
|
||||||
- name: frontend
|
|
||||||
type: https://raw.githubusercontent.com/kubernetes/deployment-manager/master/templates/replicatedservice/v1/replicatedservice.py
|
|
||||||
properties:
|
|
||||||
service_port: 80
|
|
||||||
container_port: 80
|
|
||||||
external_service: true
|
|
||||||
replicas: 3
|
|
||||||
image: gcr.io/google_containers/example-guestbook-php-redis:v3
|
|
||||||
```
|
|
||||||
|
|
||||||
(Note that we use the URL for a specific version of the template replicatedservice.py,
|
|
||||||
not just the template name.)
|
|
||||||
|
|
||||||
#### The Redis cluster
|
|
||||||
|
|
||||||
The Redis cluster consists of two replicated services: a master with a single replica
|
|
||||||
and the slaves with 2 replicas. It's defined by [this template](../../templates/redis/v1/redis.jinja),
|
|
||||||
which is a [Jinja](http://jinja.pocoo.org/) file with a [schema](../../templates/redis/v1/redis.jinja.schema).
|
|
||||||
|
|
||||||
```
|
|
||||||
{% set REDIS_PORT = 6379 %}
|
|
||||||
{% set WORKERS = properties['workers'] or 2 %}
|
|
||||||
|
|
||||||
resources:
|
|
||||||
- name: redis-master
|
|
||||||
type: https://raw.githubusercontent.com/kubernetes/deployment-manager/master/templates/replicatedservice/v1/replicatedservice.py
|
|
||||||
properties:
|
|
||||||
# This has to be overwritten since service names are hard coded in the code
|
|
||||||
service_name: redis-master
|
|
||||||
service_port: {{ REDIS_PORT }}
|
|
||||||
target_port: {{ REDIS_PORT }}
|
|
||||||
container_port: {{ REDIS_PORT }}
|
|
||||||
replicas: 1
|
|
||||||
container_name: master
|
|
||||||
image: redis
|
|
||||||
|
|
||||||
- name: redis-slave
|
|
||||||
type: https://raw.githubusercontent.com/kubernetes/deployment-manager/master/templates/replicatedservice/v1/replicatedservice.py
|
|
||||||
properties:
|
|
||||||
# This has to be overwritten since service names are hard coded in the code
|
|
||||||
service_name: redis-slave
|
|
||||||
service_port: {{ REDIS_PORT }}
|
|
||||||
container_port: {{ REDIS_PORT }}
|
|
||||||
replicas: {{ WORKERS }}
|
|
||||||
container_name: worker
|
|
||||||
image: kubernetes/redis-slave:v2
|
|
||||||
# An example of how to specify env variables.
|
|
||||||
env:
|
|
||||||
- name: GET_HOSTS_FROM
|
|
||||||
value: env
|
|
||||||
- name: REDIS_MASTER_SERVICE_HOST
|
|
||||||
value: redis-master
|
|
||||||
```
|
|
||||||
|
|
||||||
### Displaying types
|
|
||||||
|
|
||||||
You can see both the both primitive types and the templates you've deployed to the
|
|
||||||
cluster using the `deployed-types` command:
|
|
||||||
|
|
||||||
```
|
|
||||||
dm deployed-types
|
|
||||||
|
|
||||||
["Service","ReplicationController","redis.jinja","https://raw.githubusercontent.com/kubernetes/deployment-manager/master/templates/replicatedservice/v1/replicatedservice.py"]
|
|
||||||
```
|
|
||||||
|
|
||||||
This output shows 2 primitive types (Service and ReplicationController), and 2
|
|
||||||
templates (redis.jinja and one imported from github named replicatedservice.py).
|
|
||||||
|
|
||||||
You can also see where a specific type is being used with the `deployed-instances` command:
|
|
||||||
|
|
||||||
```
|
|
||||||
dm deployed-instances Service
|
|
||||||
[{"name":"frontend-service","type":"Service","deployment":"guestbook4","manifest":"manifest-1446682551242763329","path":"$.resources[0].resources[0]"},{"name":"redis-master","type":"Service","deployment":"guestbook4","manifest":"manifest-1446682551242763329","path":"$.resources[1].resources[0].resources[0]"},{"name":"redis-slave","type":"Service","deployment":"guestbook4","manifest":"manifest-1446682551242763329","path":"$.resources[1].resources[1].resources[0]"}]
|
|
||||||
```
|
|
||||||
|
|
||||||
This output describes the deployment and manifest, as well as the JSON paths to
|
|
||||||
the instances of the type within the layout.
|
|
||||||
|
|
||||||
For more information about deployments, manifests and layouts, see the
|
|
||||||
[design document](../../docs/design/design.md#api-model).
|
|
||||||
|
|
||||||
|
|
||||||
@ -1,12 +0,0 @@
|
|||||||
resources:
|
|
||||||
- name: frontend
|
|
||||||
type: github.com/kubernetes/application-dm-templates/common/replicatedservice:v1
|
|
||||||
properties:
|
|
||||||
service_port: 80
|
|
||||||
container_port: 80
|
|
||||||
external_service: true
|
|
||||||
replicas: 3
|
|
||||||
image: gcr.io/google_containers/example-guestbook-php-redis:v3
|
|
||||||
- name: redis
|
|
||||||
type: github.com/kubernetes/application-dm-templates/storage/redis:v1
|
|
||||||
properties: null
|
|
||||||
Loading…
Reference in new issue