Add code group blocks to improve worker pool docs
* Show Fedora CoreOS and Flatcar Linux examples in separate tabs, rather than trying to show one * Add copyright footer for the poseidon org
This commit is contained in:
parent
8dd221a57c
commit
d7e0536838
|
@ -15,26 +15,51 @@ Internal Terraform Modules:
|
||||||
|
|
||||||
Create a cluster following the AWS [tutorial](../flatcar-linux/aws.md#cluster). Define a worker pool using the AWS internal `workers` module.
|
Create a cluster following the AWS [tutorial](../flatcar-linux/aws.md#cluster). Define a worker pool using the AWS internal `workers` module.
|
||||||
|
|
||||||
```tf
|
=== "Fedora CoreOS"
|
||||||
module "tempest-worker-pool" {
|
|
||||||
source = "git::https://github.com/poseidon/typhoon//aws/container-linux/kubernetes/workers?ref=v1.14.3"
|
|
||||||
|
|
||||||
# AWS
|
```tf
|
||||||
vpc_id = module.tempest.vpc_id
|
module "tempest-worker-pool" {
|
||||||
subnet_ids = module.tempest.subnet_ids
|
source = "git::https://github.com/poseidon/typhoon//aws/fedora-coreos/kubernetes/workers?ref=v1.19.0"
|
||||||
security_groups = module.tempest.worker_security_groups
|
|
||||||
|
|
||||||
# configuration
|
# AWS
|
||||||
name = "tempest-pool"
|
vpc_id = module.tempest.vpc_id
|
||||||
kubeconfig = module.tempest.kubeconfig
|
subnet_ids = module.tempest.subnet_ids
|
||||||
ssh_authorized_key = var.ssh_authorized_key
|
security_groups = module.tempest.worker_security_groups
|
||||||
|
|
||||||
# optional
|
# configuration
|
||||||
worker_count = 2
|
name = "tempest-pool"
|
||||||
instance_type = "m5.large"
|
kubeconfig = module.tempest.kubeconfig
|
||||||
os_image = "flatcar-beta"
|
ssh_authorized_key = var.ssh_authorized_key
|
||||||
}
|
|
||||||
```
|
# optional
|
||||||
|
worker_count = 2
|
||||||
|
instance_type = "m5.large"
|
||||||
|
os_stream = "next"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
=== "Flatcar Linux"
|
||||||
|
|
||||||
|
```tf
|
||||||
|
module "tempest-worker-pool" {
|
||||||
|
source = "git::https://github.com/poseidon/typhoon//aws/container-linux/kubernetes/workers?ref=v1.19.0"
|
||||||
|
|
||||||
|
# AWS
|
||||||
|
vpc_id = module.tempest.vpc_id
|
||||||
|
subnet_ids = module.tempest.subnet_ids
|
||||||
|
security_groups = module.tempest.worker_security_groups
|
||||||
|
|
||||||
|
# configuration
|
||||||
|
name = "tempest-pool"
|
||||||
|
kubeconfig = module.tempest.kubeconfig
|
||||||
|
ssh_authorized_key = var.ssh_authorized_key
|
||||||
|
|
||||||
|
# optional
|
||||||
|
worker_count = 2
|
||||||
|
instance_type = "m5.large"
|
||||||
|
os_image = "flatcar-beta"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
Apply the change.
|
Apply the change.
|
||||||
|
|
||||||
|
@ -65,13 +90,13 @@ The AWS internal `workers` module supports a number of [variables](https://githu
|
||||||
|:-----|:------------|:--------|:--------|
|
|:-----|:------------|:--------|:--------|
|
||||||
| worker_count | Number of instances | 1 | 3 |
|
| worker_count | Number of instances | 1 | 3 |
|
||||||
| instance_type | EC2 instance type | "t3.small" | "t3.medium" |
|
| instance_type | EC2 instance type | "t3.small" | "t3.medium" |
|
||||||
| os_image | AMI channel for a Container Linux derivative | "flatcar-stable" | flatcar-stable, flatcar-beta, flatcar-alph, flatcar-edge |
|
| os_image | AMI channel for a Container Linux derivative | "flatcar-stable" | flatcar-stable, flatcar-beta, flatcar-alpha, flatcar-edge |
|
||||||
| os_stream | Fedora CoreOS stream for compute instances | "stable" | "testing", "next" |
|
| os_stream | Fedora CoreOS stream for compute instances | "stable" | "testing", "next" |
|
||||||
| disk_size | Size of the EBS volume in GB | 40 | 100 |
|
| disk_size | Size of the EBS volume in GB | 40 | 100 |
|
||||||
| disk_type | Type of the EBS volume | "gp2" | standard, gp2, io1 |
|
| disk_type | Type of the EBS volume | "gp2" | standard, gp2, io1 |
|
||||||
| disk_iops | IOPS of the EBS volume | 0 (i.e. auto) | 400 |
|
| disk_iops | IOPS of the EBS volume | 0 (i.e. auto) | 400 |
|
||||||
| spot_price | Spot price in USD for worker instances or 0 to use on-demand instances | 0 | 0.10 |
|
| spot_price | Spot price in USD for worker instances or 0 to use on-demand instances | 0 | 0.10 |
|
||||||
| snippets | Container Linux Config snippets | [] | [examples](/advanced/customization/) |
|
| snippets | Fedora CoreOS or Container Linux Config snippets | [] | [examples](/advanced/customization/) |
|
||||||
| service_cidr | Must match `service_cidr` of cluster | "10.3.0.0/16" | "10.3.0.0/24" |
|
| service_cidr | Must match `service_cidr` of cluster | "10.3.0.0/16" | "10.3.0.0/24" |
|
||||||
| node_labels | List of initial node labels | [] | ["worker-pool=foo"] |
|
| node_labels | List of initial node labels | [] | ["worker-pool=foo"] |
|
||||||
|
|
||||||
|
@ -81,28 +106,57 @@ Check the list of valid [instance types](https://aws.amazon.com/ec2/instance-typ
|
||||||
|
|
||||||
Create a cluster following the Azure [tutorial](../flatcar-linux/azure.md#cluster). Define a worker pool using the Azure internal `workers` module.
|
Create a cluster following the Azure [tutorial](../flatcar-linux/azure.md#cluster). Define a worker pool using the Azure internal `workers` module.
|
||||||
|
|
||||||
```tf
|
=== "Fedora CoreOS"
|
||||||
module "ramius-worker-pool" {
|
|
||||||
source = "git::https://github.com/poseidon/typhoon//azure/container-linux/kubernetes/workers?ref=v1.19.0"
|
|
||||||
|
|
||||||
# Azure
|
```tf
|
||||||
region = module.ramius.region
|
module "ramius-worker-pool" {
|
||||||
resource_group_name = module.ramius.resource_group_name
|
source = "git::https://github.com/poseidon/typhoon//azure/fedora-coreos/kubernetes/workers?ref=v1.19.0"
|
||||||
subnet_id = module.ramius.subnet_id
|
|
||||||
security_group_id = module.ramius.security_group_id
|
|
||||||
backend_address_pool_id = module.ramius.backend_address_pool_id
|
|
||||||
|
|
||||||
# configuration
|
# Azure
|
||||||
name = "ramius-spot"
|
region = module.ramius.region
|
||||||
kubeconfig = module.ramius.kubeconfig
|
resource_group_name = module.ramius.resource_group_name
|
||||||
ssh_authorized_key = var.ssh_authorized_key
|
subnet_id = module.ramius.subnet_id
|
||||||
|
security_group_id = module.ramius.security_group_id
|
||||||
|
backend_address_pool_id = module.ramius.backend_address_pool_id
|
||||||
|
|
||||||
# optional
|
# configuration
|
||||||
worker_count = 2
|
name = "ramius-spot"
|
||||||
vm_type = "Standard_F4"
|
kubeconfig = module.ramius.kubeconfig
|
||||||
priority = "Spot"
|
ssh_authorized_key = var.ssh_authorized_key
|
||||||
}
|
|
||||||
```
|
# optional
|
||||||
|
worker_count = 2
|
||||||
|
vm_type = "Standard_F4"
|
||||||
|
priority = "Spot"
|
||||||
|
os_image = "/subscriptions/some/path/Microsoft.Compute/images/fedora-coreos-31.20200323.3.2"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
=== "Flatcar Linux"
|
||||||
|
|
||||||
|
```tf
|
||||||
|
module "ramius-worker-pool" {
|
||||||
|
source = "git::https://github.com/poseidon/typhoon//azure/container-linux/kubernetes/workers?ref=v1.19.0"
|
||||||
|
|
||||||
|
# Azure
|
||||||
|
region = module.ramius.region
|
||||||
|
resource_group_name = module.ramius.resource_group_name
|
||||||
|
subnet_id = module.ramius.subnet_id
|
||||||
|
security_group_id = module.ramius.security_group_id
|
||||||
|
backend_address_pool_id = module.ramius.backend_address_pool_id
|
||||||
|
|
||||||
|
# configuration
|
||||||
|
name = "ramius-spot"
|
||||||
|
kubeconfig = module.ramius.kubeconfig
|
||||||
|
ssh_authorized_key = var.ssh_authorized_key
|
||||||
|
|
||||||
|
# optional
|
||||||
|
worker_count = 2
|
||||||
|
vm_type = "Standard_F4"
|
||||||
|
priority = "Spot"
|
||||||
|
os_image = "flatcar-beta"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
Apply the change.
|
Apply the change.
|
||||||
|
|
||||||
|
@ -147,27 +201,53 @@ Check the list of valid [machine types](https://azure.microsoft.com/en-us/pricin
|
||||||
|
|
||||||
Create a cluster following the Google Cloud [tutorial](../flatcar-linux/google-cloud.md#cluster). Define a worker pool using the Google Cloud internal `workers` module.
|
Create a cluster following the Google Cloud [tutorial](../flatcar-linux/google-cloud.md#cluster). Define a worker pool using the Google Cloud internal `workers` module.
|
||||||
|
|
||||||
```tf
|
=== "Fedora CoreOS"
|
||||||
module "yavin-worker-pool" {
|
|
||||||
source = "git::https://github.com/poseidon/typhoon//google-cloud/container-linux/kubernetes/workers?ref=v1.19.0"
|
|
||||||
|
|
||||||
# Google Cloud
|
```tf
|
||||||
region = "europe-west2"
|
module "yavin-worker-pool" {
|
||||||
network = module.yavin.network_name
|
source = "git::https://github.com/poseidon/typhoon//google-cloud/fedora-coreos/kubernetes/workers?ref=v1.19.0"
|
||||||
cluster_name = "yavin"
|
|
||||||
|
|
||||||
# configuration
|
# Google Cloud
|
||||||
name = "yavin-16x"
|
region = "europe-west2"
|
||||||
kubeconfig = module.yavin.kubeconfig
|
network = module.yavin.network_name
|
||||||
ssh_authorized_key = var.ssh_authorized_key
|
cluster_name = "yavin"
|
||||||
|
|
||||||
# optional
|
# configuration
|
||||||
worker_count = 2
|
name = "yavin-16x"
|
||||||
machine_type = "n1-standard-16"
|
kubeconfig = module.yavin.kubeconfig
|
||||||
os_image = "coreos-beta"
|
ssh_authorized_key = var.ssh_authorized_key
|
||||||
preemptible = true
|
|
||||||
}
|
# optional
|
||||||
```
|
worker_count = 2
|
||||||
|
machine_type = "n1-standard-16"
|
||||||
|
os_stream = "testing"
|
||||||
|
preemptible = true
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
=== "Flatcar Linux"
|
||||||
|
|
||||||
|
```tf
|
||||||
|
module "yavin-worker-pool" {
|
||||||
|
source = "git::https://github.com/poseidon/typhoon//google-cloud/container-linux/kubernetes/workers?ref=v1.19.0"
|
||||||
|
|
||||||
|
# Google Cloud
|
||||||
|
region = "europe-west2"
|
||||||
|
network = module.yavin.network_name
|
||||||
|
cluster_name = "yavin"
|
||||||
|
|
||||||
|
# configuration
|
||||||
|
name = "yavin-16x"
|
||||||
|
kubeconfig = module.yavin.kubeconfig
|
||||||
|
ssh_authorized_key = var.ssh_authorized_key
|
||||||
|
|
||||||
|
# optional
|
||||||
|
worker_count = 2
|
||||||
|
machine_type = "n1-standard-16"
|
||||||
|
os_image = "flatcar-linux-2303-4-0" # custom
|
||||||
|
preemptible = true
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
Apply the change.
|
Apply the change.
|
||||||
|
|
||||||
|
|
|
@ -1,6 +1,7 @@
|
||||||
site_name: Typhoon
|
site_name: Typhoon
|
||||||
site_description: A minimal and free Kubernetes distribution
|
site_description: A minimal and free Kubernetes distribution
|
||||||
site_author: Dalton Hubble
|
site_author: Dalton Hubble
|
||||||
|
copyright: Poseidon Labs
|
||||||
repo_name: poseidon/typhoon
|
repo_name: poseidon/typhoon
|
||||||
repo_url: https://github.com/poseidon/typhoon
|
repo_url: https://github.com/poseidon/typhoon
|
||||||
theme:
|
theme:
|
||||||
|
@ -41,6 +42,7 @@ markdown_extensions:
|
||||||
- pymdownx.mark
|
- pymdownx.mark
|
||||||
- pymdownx.smartsymbols
|
- pymdownx.smartsymbols
|
||||||
- pymdownx.superfences
|
- pymdownx.superfences
|
||||||
|
- pymdownx.tabbed
|
||||||
- pymdownx.tasklist:
|
- pymdownx.tasklist:
|
||||||
custom_checkbox: true
|
custom_checkbox: true
|
||||||
- pymdownx.tilde
|
- pymdownx.tilde
|
||||||
|
|
Loading…
Reference in New Issue