From bae4457cf26e03e9fe75fb8579a26980d6ed37b8 Mon Sep 17 00:00:00 2001 From: Michael Barz Date: Wed, 30 Sep 2020 17:20:34 +0200 Subject: [PATCH] delete old accounts docs --- accounts/Makefile | 19 -------- accounts/docs/_index.md | 21 -------- accounts/docs/building.md | 28 ----------- accounts/docs/configuration.md | 84 -------------------------------- accounts/docs/getting-started.md | 61 ----------------------- 5 files changed, 213 deletions(-) delete mode 100644 accounts/docs/_index.md delete mode 100644 accounts/docs/building.md delete mode 100644 accounts/docs/configuration.md delete mode 100644 accounts/docs/getting-started.md diff --git a/accounts/Makefile b/accounts/Makefile index 8cd18f0ba2..ee90973fb9 100644 --- a/accounts/Makefile +++ b/accounts/Makefile @@ -135,25 +135,6 @@ release-check: .PHONY: release-finish release-finish: release-copy release-check -.PHONY: docs-copy -docs-copy: - mkdir -p $(HUGO); \ - mkdir -p $(HUGO)/content/extensions; \ - cd $(HUGO); \ - git init; \ - git remote rm origin; \ - git remote add origin https://github.com/owncloud/owncloud.github.io; \ - git fetch; \ - git checkout origin/source -f; \ - rsync --delete -ax ../docs/ content/extensions/$(NAME) - -.PHONY: docs-build -docs-build: - cd $(HUGO); hugo - -.PHONY: docs -docs: docs-copy docs-build - .PHONY: test-acceptance-webui test-acceptance-webui: ./ui/tests/run-acceptance-test.sh $(FEATURE_PATH) diff --git a/accounts/docs/_index.md b/accounts/docs/_index.md deleted file mode 100644 index 3249c0241d..0000000000 --- a/accounts/docs/_index.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Accounts -date: 2018-05-02T00:00:00+00:00 -weight: 10 -geekdocRepo: https://github.com/owncloud/ocis-accounts -geekdocEditPath: edit/master/docs -geekdocFilePath: _index.md ---- - -[![GitHub](https://img.shields.io/github/license/owncloud/ocis-hello)](https://github.com/owncloud/ocis-hello/blob/master/LICENSE) - -## Abstract -OCIS needs to be able to identify users. Whithout a non reassignable and persistend account ID share metadata cannot be reliably persisted. `ocis-accounts` allows exchanging oidc claims for a uuid. Using a uuid allows users to change the login, mail or even openid connect provider without breaking any persisted metadata that might have been attached to it. - -- persists accounts -- uses graph api properties - -ldap can be synced using the onpremise* attributes - -## Table of Contents - -{{< toc-tree >}} \ No newline at end of file diff --git a/accounts/docs/building.md b/accounts/docs/building.md deleted file mode 100644 index 2d96c7ceb3..0000000000 --- a/accounts/docs/building.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: "Building" -date: 2018-05-02T00:00:00+00:00 -weight: 30 -geekdocRepo: https://github.com/owncloud/ocis-accounts -geekdocEditPath: edit/master/docs -geekdocFilePath: building.md ---- - -{{< toc >}} - -As this project is built with Go, so you need to install that first. The installation of Go is out of the scope of this document, please follow the official documentation for [Go](https://golang.org/doc/install), to build this project you have to install Go >= v1.13. After the installation of the required tools you need to get the sources: - -{{< highlight txt >}} -git clone https://github.com/owncloud/ocis-accounts.git -cd ocis-accounts -{{< / highlight >}} - -All required tool besides Go itself and make are bundled or getting automatically installed within the `GOPATH`. All commands to build this project are part of our `Makefile`. - -## Backend - -{{< highlight txt >}} -make generate -make build -{{< / highlight >}} - -Finally you should have the binary within the `bin/` folder now, give it a try with `./bin/ocis-accounts -h` to see all available options and subcommands. diff --git a/accounts/docs/configuration.md b/accounts/docs/configuration.md deleted file mode 100644 index f6c3830234..0000000000 --- a/accounts/docs/configuration.md +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: "Configuration" -date: "2020-07-01T11:10:52+0200" -weight: 20 -geekdocRepo: https://github.com/owncloud/ocis-reva -geekdocEditPath: edit/master/docs -geekdocFilePath: configuration.md ---- - -{{< toc >}} - -## Configuration - -oCIS Single Binary is not responsible for configuring extensions. Instead, each extension could either be configured by environment variables, cli flags or config files. - -Each extension has its dedicated documentation page (e.g. https://owncloud.github.io/extensions/ocis_proxy/configuration) which lists all possible configurations. Config files and environment variables are picked up if you use the `./bin/ocis server` command within the oCIS single binary. Command line flags must be set explicitly on the extensions subcommands. - -### Configuration using config files - -Out of the box extensions will attempt to read configuration details from: - -```console -/etc/ocis -$HOME/.ocis -./config -``` - -For this configuration to be picked up, have a look at your extension `root` command and look for which default config name it has assigned. *i.e: ocis-proxy reads `proxy.json | yaml | toml ...`*. - -So far we support the file formats `JSON` and `YAML`, if you want to get a full example configuration just take a look at [our repository](https://github.com/owncloud/ocis/tree/master/config), there you can always see the latest configuration format. These example configurations include all available options and the default values. The configuration file will be automatically loaded if it's placed at `/etc/ocis/ocis.yml`, `${HOME}/.ocis/ocis.yml` or `$(pwd)/config/ocis.yml`. - -### Envrionment variables - -If you prefer to configure the service with environment variables you can see the available variables below. - -### Commandline flags - -If you prefer to configure the service with commandline flags you can see the available variables below. Command line flags are only working when calling the subcommand directly. - -### ocis-reva server - -Start ocis accounts service - -Usage: `ocis-reva server [command options] [arguments...]` - ---http-namespace | $ACCOUNTS_HTTP_NAMESPACE -: Set the base namespace for the http namespace. Default: `com.owncloud.web`. - ---http-addr | $ACCOUNTS_HTTP_ADDR -: Address to bind http server. Default: `localhost:9181`. - ---http-root | $ACCOUNTS_HTTP_ROOT -: Root path of http server. Default: `/`. - ---grpc-namespace | $ACCOUNTS_GRPC_NAMESPACE -: Set the base namespace for the grpc namespace. Default: `com.owncloud.api`. - ---grpc-addr | $ACCOUNTS_GRPC_ADDR -: Address to bind grpc server. Default: `localhost:9180`. - ---name | $ACCOUNTS_NAME -: service name. Default: `accounts`. - ---accounts-data-path | $ACCOUNTS_DATA_PATH -: accounts folder. Default: `/var/tmp/ocis-accounts`. - ---asset-path | $HELLO_ASSET_PATH -: Path to custom assets. - -### ocis-reva ocis-accounts - -Provide accounts and groups for oCIS - -Usage: `ocis-reva ocis-accounts [command options] [arguments...]` - ---log-level | $ACCOUNTS_LOG_LEVEL -: Set logging level. Default: `info`. - ---log-pretty | $ACCOUNTS_LOG_PRETTY -: Enable pretty logging. Default: `true`. - ---log-color | $ACCOUNTS_LOG_COLOR -: Enable colored logging. Default: `true`. - diff --git a/accounts/docs/getting-started.md b/accounts/docs/getting-started.md deleted file mode 100644 index d389b843ca..0000000000 --- a/accounts/docs/getting-started.md +++ /dev/null @@ -1,61 +0,0 @@ ---- -title: "Getting Started" -date: 2018-05-02T00:00:00+00:00 -weight: 20 -geekdocRepo: https://github.com/owncloud/ocis-accounts -geekdocEditPath: edit/master/docs -geekdocFilePath: getting-started.md ---- - -{{< toc >}} - -## Installation - -So far we are offering two different variants for the installation. You can choose between [Docker](https://www.docker.com/) or pre-built binaries which are stored on our download mirrors and GitHub releases. Maybe we will also provide system packages for the major distributions later if we see the need for it. - -### Docker - -TBD - -### Binaries - -TBD - -## Configuration - -We provide overall three different variants of configuration. The variant based on environment variables and commandline flags are split up into global values and command-specific values. - -### Envrionment variables - -If you prefer to configure the service with environment variables you can see the available variables below. - -#### Server - -OCIS_ACCOUNTS_NAME -: Name of the accounts service. It will be part of the namespace. - -OCIS_ACCOUNTS_NAMESPACE -: Namespace of the accounts service. - -OCIS_ACCOUNTS_ADDRESS -: Endpoint for the grpc service endpoint. - -### Commandline flags - -If you prefer to configure the service with commandline flags you can see the available variables below. - -### Configuration file - -So far we support the file formats `JSON` and `YAML`, if you want to get a full example configuration just take a look at [our repository](https://github.com/owncloud/ocis/accounts/tree/master/pkg/config), there you can always see the latest configuration format. These example configurations include all available options and the default values. The configuration file will be automatically loaded if it's placed at `/etc/ocis/accounts.yml`, `${HOME}/.ocis/accounts.yml` or `$(pwd)/config/accounts.yml`. - -## Usage - -The program provides a few sub-commands on execution. The available configuration methods have already been mentioned above. Generally you can always see a formated help output if you execute the binary via `ocis-accounts --help`. - -### Server - -The server command is used to start the grpc server. For further help please execute: - -{{< highlight txt >}} -ocis-accounts server --help -{{< / highlight >}}