142 lines
4.4 KiB
Text
142 lines
4.4 KiB
Text
= myCloud
|
|
|
|
a bundle of OpenSource Software with one user management.
|
|
|
|
Current based only on: https://goauthentik.io[authentik]
|
|
|
|
== First Login
|
|
Your main Account must be initalized:
|
|
`https://auth.<commons.ingress.domain>/if/flow/initial-setup/`
|
|
|
|
== Components
|
|
|
|
The following components for an myCloud setup exists:
|
|
include::partial-list-components.adoc[]
|
|
|
|
== Usage
|
|
|
|
My `base-values/mycloud-*.yaml` does not set any namespace, so the same the the Base-Helmchart is used (maybe you like to use multiple myClouds in different namespaces).
|
|
|
|
.Example usage (warning, the `base-values` are not versioned, see xref:base:index.adoc[Base]):
|
|
[source,yaml]
|
|
----
|
|
---
|
|
apiVersion: v1
|
|
kind: Namespace
|
|
metadata:
|
|
name: mycloud <1>
|
|
|
|
---
|
|
apiVersion: v1
|
|
kind: Secret <2>
|
|
metadata:
|
|
name: mycloud-mail
|
|
namespace: mycloud <1>
|
|
data:
|
|
password: MAIL_ACCOUNT_PASSWORD
|
|
|
|
---
|
|
apiVersion: v1
|
|
kind: Secret <3>
|
|
metadata:
|
|
name: mycloud-master-password
|
|
namespace: mycloud <1>
|
|
data:
|
|
masterPassword: MASTER_PASSWORD_FOR_GENERATE_EVERY_A_NEW_ONE
|
|
|
|
---
|
|
apiVersion: source.toolkit.fluxcd.io/v1
|
|
kind: GitRepository
|
|
metadata:
|
|
name: wrenix-flux-charts <4>
|
|
namespace: flux-system
|
|
spec:
|
|
url: https://codeberg.org/wrenix/flux-charts.git
|
|
ref:
|
|
branch: main
|
|
interval: 10m
|
|
# for more info about verification take an look here:
|
|
# - https://fluxcd.io/flux/components/source/gitrepositories/#verification
|
|
# - https://wrenix.codeberg.page/docs/wrenix-flux/latest/#_secure_with_verify
|
|
# later replaced with oci and cosign
|
|
# verify:
|
|
# mode: HEAD
|
|
# secretRef:
|
|
# name: gpg-publickey
|
|
|
|
---
|
|
apiVersion: helm.toolkit.fluxcd.io/v2beta1
|
|
kind: HelmRelease
|
|
metadata:
|
|
name: mycloud <5>
|
|
namespace: mycloud <1>
|
|
spec:
|
|
chart:
|
|
spec:
|
|
sourceRef:
|
|
kind: GitRepository
|
|
name: wrenix-flux-charts <4>
|
|
namespace: flux-system
|
|
chart: "./base"
|
|
reconcileStrategy: "Revision"
|
|
valuesFiles:
|
|
- "./base/values.yaml"
|
|
- "./base-values/commons.yaml" <6>
|
|
- "./base-values/mycloud-core.yaml" <7>
|
|
- "./base-values/mycloud-nextcloud.yaml" <8>
|
|
- "./base-values/mycloud-collabora.yaml" <9>
|
|
interval: 10m
|
|
values:
|
|
##
|
|
# Commons
|
|
##
|
|
commons:
|
|
mail: <10>
|
|
host: "posteo.de"
|
|
username: "mycloud@posteo.net"
|
|
use_tls: true
|
|
from: "mycloud@posteo.net"
|
|
|
|
helm:
|
|
chart:
|
|
sourceRef: <4>
|
|
kind: GitRepository
|
|
name: wrenix-flux-charts
|
|
namespace: flux-system
|
|
|
|
ingress:
|
|
domain: "mycloud.eu" <11>
|
|
|
|
componentCommons:
|
|
helm:
|
|
release:
|
|
valuesFrom:
|
|
- kind: Secret <3>
|
|
name: mycloud-master-password
|
|
valuesKey: masterPassword
|
|
targetPath: commons.masterPassword
|
|
- kind: Secret <2>
|
|
name: mycloud-mail
|
|
valuesKey: password
|
|
targetPath: commons.mail.password
|
|
|
|
##
|
|
# Compoments
|
|
##
|
|
components:
|
|
mycloud-nextcloud:
|
|
values: <12>
|
|
quota: "100 MB"
|
|
----
|
|
<1> namespace where install all the components later
|
|
<2> secret to bypass secure values into the mycloud-components (mail)
|
|
<3> secret to bypass secure values into the mycloud-components (masterPassword)
|
|
<4> reference where base and all the components are founded by fluxcd
|
|
<5> use of base-helm chart for fluxcd to bundle the different mycloud-components together
|
|
<6> use my default commons values for flux-chart components
|
|
<7> use my default to setup all commons for mycloud-components and the mycloud-core components (e.g. xref:components:mycloud-services.adoc[mycloud-services] and xref:components:mycloud-authentik.adoc[mycloud-authentik])
|
|
<8> use my default values for usage of xref:components:mycloud-nextcloud.adoc[mycloud-nextcloud] (it also configure xref:components:mycloud-services.adoc[mycloud-services] for another database and xref:components:mycloud-authentik.adoc[mycloud-authentik] for user management)
|
|
<9> use my default values for usage of xref:components:mycloud-collabora.adoc[mycloud-collabora] (it also configure xref:components:mycloud-nextcloud.adoc[mycloud-nextcloud] if it is also used)
|
|
<10> setup default mail configuration (for all components) for more commons values take an look into the used components (or `base-values`)
|
|
<11> setup default domain (where subdomains are generate for the different components)
|
|
<12> overwrite componets values (here setup default quota for an use in xref:components:mycloud-nextcloud.adoc[mycloud-nextcloud])
|