kubernetes
/
website
mirror of https://github.com/kubernetes/website.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Reorganize Federation tasks so we have it group and under one topic (#12900) 

* Reorganize Federation tasks so we have it group and under one topic

* Intended replacement
pull/13141/head
Dani Comnea 2019-03-12 20:38:39 +00:00 committed by Kubernetes Prow Robot
parent d7cae63dcd
commit 56021dc671
29 changed files with 86 additions and 68 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
content/en/docs/concepts/cluster-administration/federation.md
View File

@ -6,7 +6,9 @@ weight: 80
{{% capture overview %}}
{{< include "federation-current-state.md" >}}
{{< deprecationfilewarning >}}
{{< include "federation-deprecation-warning-note.md" >}}
{{< /deprecationfilewarning >}}
This page explains why and how to manage multiple Kubernetes clusters using
federation.

1
content/en/docs/contribute/style/content-organization.md
View File

@ -108,7 +108,6 @@ Another widely used example is the `includes` bundle. It sets `headless: true` i
en/includes
├── default-storage-class-prereqs.md
├── federated-task-tutorial-prereqs.md
├── federation-content-moved.md
├── index.md
├── partner-script.js
├── partner-style.css

2
content/en/docs/contribute/style/style-guide.md
View File

@ -327,7 +327,7 @@ Shortcodes inside include statements will break the build. You must insert them
```
{{</* note */>}}
{{</* include "federation-current-state.md" */>}}
{{</* include "task-tutorial-prereqs.md" */>}}
{{</* /note */>}}
```

5
content/en/docs/tasks/administer-federation/_index.md
View File

@ -1,5 +0,0 @@
---
title: "Federation - Run an App on Multiple Clusters"
weight: 160
---

2
content/en/docs/tasks/federation/_index.md
View File

@ -1,5 +1,5 @@
---
title: "Federation - Run an App on Multiple Clusters"
title: "Federation"
weight: 120
---

5
content/en/docs/tasks/federation/administer-federation/_index.md Executable file
View File

@ -0,0 +1,5 @@
---
title: "Administer Federation Control Plane"
weight: 160
---

6
content/en/docs/tasks/administer-federation/cluster.md → content/en/docs/tasks/federation/administer-federation/cluster.md
View File

@ -5,9 +5,9 @@ content_template: templates/task
{{% capture overview %}}
{{< note >}}
{{< include "federation-current-state.md" >}}
{{< /note >}}
{{< deprecationfilewarning >}}
{{< include "federation-deprecation-warning-note.md" >}}
{{< /deprecationfilewarning >}}
This guide explains how to use Clusters API resource in a Federation control plane.

6
content/en/docs/tasks/administer-federation/configmap.md → content/en/docs/tasks/federation/administer-federation/configmap.md
View File

@ -5,9 +5,9 @@ content_template: templates/task
{{% capture overview %}}
{{< note >}}
{{< include "federation-current-state.md" >}}
{{< /note >}}
{{< deprecationfilewarning >}}
{{< include "federation-deprecation-warning-note.md" >}}
{{< /deprecationfilewarning >}}
This guide explains how to use ConfigMaps in a Federation control plane.

6
content/en/docs/tasks/administer-federation/daemonset.md → content/en/docs/tasks/federation/administer-federation/daemonset.md
View File

@ -5,9 +5,9 @@ content_template: templates/task
{{% capture overview %}}
{{< note >}}
{{< include "federation-current-state.md" >}}
{{< /note >}}
{{< deprecationfilewarning >}}
{{< include "federation-deprecation-warning-note.md" >}}
{{< /deprecationfilewarning >}}
This guide explains how to use DaemonSets in a federation control plane.

6
content/en/docs/tasks/administer-federation/deployment.md → content/en/docs/tasks/federation/administer-federation/deployment.md
View File

@ -5,9 +5,9 @@ content_template: templates/task
{{% capture overview %}}
{{< note >}}
{{< include "federation-current-state.md" >}}
{{< /note >}}
{{< deprecationfilewarning >}}
{{< include "federation-deprecation-warning-note.md" >}}
{{< /deprecationfilewarning >}}
This guide explains how to use Deployments in the Federation control plane.

6
content/en/docs/tasks/administer-federation/events.md → content/en/docs/tasks/federation/administer-federation/events.md
View File

@ -5,9 +5,9 @@ content_template: templates/concept
{{% capture overview %}}
{{< note >}}
{{< include "federation-current-state.md" >}}
{{< /note >}}
{{< deprecationfilewarning >}}
{{< include "federation-deprecation-warning-note.md" >}}
{{< /deprecationfilewarning >}}
This guide explains how to use events in federation control plane to help in debugging.

6
content/en/docs/tasks/administer-federation/hpa.md → content/en/docs/tasks/federation/administer-federation/hpa.md
View File

@ -7,9 +7,9 @@ content_template: templates/task
{{< feature-state state="alpha" >}}
{{< note >}}
{{< include "federation-current-state.md" >}}
{{< /note >}}
{{< deprecationfilewarning >}}
{{< include "federation-deprecation-warning-note.md" >}}
{{< /deprecationfilewarning >}}
This guide explains how to use federated horizontal pod autoscalers (HPAs) in the federation control plane.

6
content/en/docs/tasks/administer-federation/ingress.md → content/en/docs/tasks/federation/administer-federation/ingress.md
View File

@ -5,9 +5,9 @@ content_template: templates/task
{{% capture overview %}}
{{< note >}}
{{< include "federation-current-state.md" >}}
{{< /note >}}
{{< deprecationfilewarning >}}
{{< include "federation-deprecation-warning-note.md" >}}
{{< /deprecationfilewarning >}}
This page explains how to use Kubernetes Federated Ingress to deploy
a common HTTP(S) virtual IP load balancer across a federated service running in

6
content/en/docs/tasks/administer-federation/job.md → content/en/docs/tasks/federation/administer-federation/job.md
View File

@ -5,9 +5,9 @@ content_template: templates/task
{{% capture overview %}}
{{< note >}}
{{< include "federation-current-state.md" >}}
{{< /note >}}
{{< deprecationfilewarning >}}
{{< include "federation-deprecation-warning-note.md" >}}
{{< /deprecationfilewarning >}}
This guide explains how to use jobs in the federation control plane.

6
content/en/docs/tasks/administer-federation/namespaces.md → content/en/docs/tasks/federation/administer-federation/namespaces.md
View File

@ -5,9 +5,9 @@ content_template: templates/task
{{% capture overview %}}
{{< note >}}
{{< include "federation-current-state.md" >}}
{{< /note >}}
{{< deprecationfilewarning >}}
{{< include "federation-deprecation-warning-note.md" >}}
{{< /deprecationfilewarning >}}
This guide explains how to use Namespaces in Federation control plane.

6
content/en/docs/tasks/administer-federation/replicaset.md → content/en/docs/tasks/federation/administer-federation/replicaset.md
View File

@ -5,9 +5,9 @@ content_template: templates/task
{{% capture overview %}}
{{< note >}}
{{< include "federation-current-state.md" >}}
{{< /note >}}
{{< deprecationfilewarning >}}
{{< include "federation-deprecation-warning-note.md" >}}
{{< /deprecationfilewarning >}}
This guide explains how to use ReplicaSets in the Federation control plane.

6
content/en/docs/tasks/administer-federation/secret.md → content/en/docs/tasks/federation/administer-federation/secret.md
View File

@ -5,9 +5,9 @@ content_template: templates/concept
{{% capture overview %}}
{{< note >}}
{{< include "federation-current-state.md" >}}
{{< /note >}}
{{< deprecationfilewarning >}}
{{< include "federation-deprecation-warning-note.md" >}}
{{< /deprecationfilewarning >}}
This guide explains how to use secrets in Federation control plane.

9
content/en/docs/tasks/federation/federation-service-discovery.md
View File

@ -1,16 +1,17 @@
---
title: Cross-cluster Service Discovery using Federated Services
reviewers:
- bprashanth
- quinton-hoole
content_template: templates/task
title: Cross-cluster Service Discovery using Federated Services
weight: 140
---
{{% capture overview %}}
{{< note >}}
{{< include "federation-current-state.md" >}}
{{< /note >}}
{{< deprecationfilewarning >}}
{{< include "federation-deprecation-warning-note.md" >}}
{{< /deprecationfilewarning >}}
This guide explains how to use Kubernetes Federated Services to deploy
a common Service across multiple Kubernetes clusters. This makes it

10
content/en/docs/tasks/federation/set-up-cluster-federation-kubefed.md
View File

@ -1,14 +1,16 @@
---
title: Set up Cluster Federation with Kubefed
reviewers:
- madhusudancs
content_template: templates/task
title: Set up Cluster Federation with Kubefed
weight: 125
---
{{% capture overview %}}
{{< note >}}
{{< include "federation-current-state.md" >}}
{{< /note >}}
{{< deprecationfilewarning >}}
{{< include "federation-deprecation-warning-note.md" >}}
{{< /deprecationfilewarning >}}
Kubernetes version 1.5 and above includes a new command line tool called
[`kubefed`](/docs/admin/kubefed/) to help you administrate your federated

7
content/en/docs/tasks/federation/set-up-coredns-provider-federation.md
View File

@ -1,13 +1,14 @@
---
title: Set up CoreDNS as DNS provider for Cluster Federation
content_template: templates/tutorial
weight: 130
---
{{% capture overview %}}
{{< note >}}
{{< include "federation-current-state.md" >}}
{{< /note >}}
{{< deprecationfilewarning >}}
{{< include "federation-deprecation-warning-note.md" >}}
{{< /deprecationfilewarning >}}
This page shows how to configure and deploy CoreDNS to be used as the
DNS provider for Cluster Federation.

7
content/en/docs/tasks/federation/set-up-placement-policies-federation.md
View File

@ -1,13 +1,14 @@
---
title: Set up placement policies in Federation
content_template: templates/task
weight: 135
---
{{% capture overview %}}
{{< note >}}
{{< include "federation-current-state.md" >}}
{{< /note >}}
{{< deprecationfilewarning >}}
{{< include "federation-deprecation-warning-note.md" >}}
{{< /deprecationfilewarning >}}
This page shows how to enforce policy-based placement decisions over Federated
resources using an external policy engine.

2
content/en/docs/test.md
View File

@ -344,7 +344,7 @@ Warnings point out something that could cause harm if ignored.
To add shortcodes to includes.
{{< note >}}
{{< include "federation-current-state.md" >}}
{{< include "task-tutorial-prereqs.md" >}}
{{< /note >}}
## Katacoda Embedded Live Environment

11
content/en/includes/federated-task-tutorial-prereqs.md
View File

@ -1,8 +1,5 @@
This guide assumes that you have a running Kubernetes Cluster
Federation installation. If not, then head over to the
[federation admin guide](/docs/tutorials/federation/set-up-cluster-federation-kubefed/) to learn how to
bring up a cluster federation (or have your cluster administrator do
this for you).
Other tutorials, such as Kelsey Hightower's
[Federated Kubernetes Tutorial](https://github.com/kelseyhightower/kubernetes-cluster-federation),
This guide assumes that you have a running Kubernetes Cluster Federation installation.
If not, then head over to the [federation admin guide](/docs/tutorials/federation/set-up-cluster-federation-kubefed/) to learn how to
bring up a cluster federation (or have your cluster administrator do this for you).
Other tutorials, such as Kelsey Hightower's [Federated Kubernetes Tutorial](https://github.com/kelseyhightower/kubernetes-cluster-federation),
might also help you create a Federated Kubernetes cluster.

2
content/en/includes/federation-content-moved.md
View File

@ -1,2 +0,0 @@
The topics in the [Federation API](/docs/federation/api-reference/) section of the Kubernetes docs
are being moved to the [Reference](/docs/reference/) section. The content in this topic has moved to:

1
content/en/includes/federation-current-state.md
View File

@ -1 +0,0 @@
`Federation V1`, the current Kubernetes federation API which reuses the Kubernetes API resources 'as is', is currently considered alpha for many of its features. There is no clear path to evolve the API to GA; however, there is a `Federation V2` effort in progress to implement a dedicated federation API apart from the Kubernetes API. The details are available at [sig-multicluster community page](https://github.com/kubernetes/community/tree/master/sig-multicluster).

3
content/en/includes/federation-deprecation-warning-note.md Normal file
View File

@ -0,0 +1,3 @@
Use of `Federation v1` is strongly discouraged. `Federation V1` never achieved GA status and is no longer under active development. Documentation is for historical purposes only.
For more information, see the intended replacement, [Kubernetes Federation v2](https://github.com/kubernetes-sigs/federation-v2).

3
i18n/en.toml
View File

@ -3,6 +3,9 @@
[deprecation_warning]
other = " documentation is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, see "
[deprecation_file_warning]
other = "Deprecated"
[objectives_heading]
other = "Objectives"

3
layouts/shortcodes/deprecationfilewarning.html Normal file
View File

@ -0,0 +1,3 @@
<blockquote class="deprecation_file_warning">
<div><h4>{{ T "deprecation_file_warning" }}</h4> {{ .Inner | markdownify }}</div>
</blockquote>

9
static/css/callouts.css
View File

@ -49,3 +49,12 @@
color: #a94442;
border-color: #ebccd1;
}
.deprecation_file_warning {
padding: 20px;
margin: 20px 0;
border: 1px solid #eee;
border-left-color: #d9534f;
border-left-width: 5px;
border-radius: 3px;
}