Skip to content
This repository has been archived by the owner on Feb 23, 2024. It is now read-only.

Commit

Permalink
Add: Alibaba Cloud documentation
Browse files Browse the repository at this point in the history
Signed-off-by: Nicolas Lamirault <nicolas.lamirault@gmail.com>
  • Loading branch information
nlamirault committed Jan 7, 2022
1 parent 9231ff2 commit 7c89f20
Show file tree
Hide file tree
Showing 10 changed files with 154 additions and 1 deletion.
10 changes: 10 additions & 0 deletions content/en/docs/alicloud/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
+++
title = "Portefaix on Alibaba Cloud"
description = "Running Portefaix on Alibaba Cloud ACK"
weight = 50
+++

<img src="/docs/images/portefaix-alicloud-infra.svg" alt="Portefaix components" class="mt-3 mb-3 rounded">

<img src="/docs/images/portefaix-alicloud.svg" alt="Portefaix components" class="mt-3 mb-3 rounded">

35 changes: 35 additions & 0 deletions content/en/docs/alicloud/authentication.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
+++
title = "Authentication and Authorization"
description = "Authentication and authorization support for Portefaix in Alibaba Cloud"
weight = 10
+++

This section shows the how to setup Portefaix with authentication and authorization support in Alibaba Cloud

## Configure Alibaba Cloud

```shell
. ./portefaix.sh alicloud
[ Portefaix ]
Setup credentials
Done
```

## Bastion

{{% alert title="Work In Progress" color="warning" %}}
{{% /alert %}}

## Configure kubectl

{{% alert title="Work In Progress" color="warning" %}}
{{% /alert %}}

```shell
❯ make kubernetes-credentials CLOUD=alicloud ENV=staging
```

```shell
❯ kubectl get nodes
NAME STATUS ROLES AGE VERSION
```
8 changes: 8 additions & 0 deletions content/en/docs/alicloud/deploy/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
+++
title = "Deployment"
description = "Instructions for deploying Portefaix on Alibaba Cloud ACK"
weight = 1
+++

{{% alert title="Work In Progress" color="warning" %}}
{{% /alert %}}
25 changes: 25 additions & 0 deletions content/en/docs/alicloud/deploy/inspec-portefaix.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
+++
title = "Inspec Portefaix"
description = "Instructions for check Portefaix infrastructure on Alibaba Cloud"
weight = 20
+++

[Inspec](http://inspec.io/) is used to check infrastructure.

Check:

```shell
❯ make -f hack/build/alicloud.mk inspec-alicloud-debug
```

Execute tests:

{{% alert title="Work In Progress" color="warning" %}}
{{% /alert %}}


## CIS Kubernetes Benchmark

```shell
❯ make -f hack/build/alicloud.mk inspec-alicloud-kubernetes ENV=staging
```
60 changes: 60 additions & 0 deletions content/en/docs/alicloud/deploy/install-portefaix.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
+++
title = "Install Portefaix"
description = "Instructions for deploying Portefaix on Alibaba Cloud"
weight = 10
+++

<a id="alicloud"></a>

## Setup

Create an admin user, then API Keys.
And configure Portefaix environment file `${HOME}/.config/portefaix/portefaix.sh`:

```shell
# Alicloud
function setup_alicloud() {
# Alicloud User: Portefaix Admin
export ALICLOUD_ACCESS_KEY="xxxxxxxxxx"
export ALICLOUD_SECRET_KEY="xxxxxxxxxxxxxxxx"
export ALICLOUD_REGION="eu-central-1"
# For Terraform Cloud
export TF_VAR_access_key="${ALICLOUD_ACCESS_KEY}"
export TF_VAR_secret_key="${ALICLOUD_SECRET_KEY}"
export TF_VAR_region="${ALICLOUD_REGION}"
}
```

And load environment :

```shell
. ./portefaix.sh alicloud
```

## Storage for Terraform

Create an OSS bucket for Terraform states:

```shell
❯ make -f hack/build/alicloud.mk aliyun-bucket-create ENV=staging
```

Create a TableStore instance:

```shell
❯ make -f hack/build/alicloud.mk aliyun-tablestore-create ENV=staging
```

<a id="alicloud-terraform-cloud"></a>

## Terraform Cloud / Github Actions

[Terraform Cloud](https://terraform.cloud) is used as the remote backend. [Github Actions](https://github.com/features/actions) perform tasks to deploy the Alibaba Cloud infrastructure.

<img src="/docs/images/portefaix-alicloud-deploy.png" alt="Portefaix Alibaba Cloud deployment" class="mt-3 mb-3 rounded">

<a id="alicloud-gitops"></a>

## Gitops for Kubernetes

See : [Gitops with FluxCD](/docs/development/gitops-fluxcd) or [Gitops with ArgoCD](/docs/development/gitops-argocd/)
5 changes: 5 additions & 0 deletions content/en/docs/alicloud/deploy/uninstall-portefaix.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
+++
title = "Uninstall Portefaix"
description = "Instructions for uninstall Portefaix"
weight = 30
+++
5 changes: 5 additions & 0 deletions content/en/docs/alicloud/troubleshooting-alicloud.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
+++
title = "Troubleshooting Deployments on Alibaba Cloud ACK"
description = "Help diagnose and fix issues you may encounter in your Portefaix deployment"
weight = 100
+++
2 changes: 1 addition & 1 deletion content/en/docs/exoscale/_index.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
+++
title = "Portefaix on Exoscale"
description = "Running Portefaix on Exoscale SKS"
weight = 50
weight = 70
+++

<img src="/docs/images/portefaix-exoscale-infra.svg" alt="Infrastructure" class="mt-3 mb-3 rounded">
Expand Down
4 changes: 4 additions & 0 deletions content/en/docs/images/portefaix-alicloud-infra.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions portefaix-alicloud-infra.xml

Large diffs are not rendered by default.

0 comments on commit 7c89f20

Please sign in to comment.