From 3facec2f0345ec16e6beeb02ee1ab45552e37cf8 Mon Sep 17 00:00:00 2001 From: Stuart Clements Date: Thu, 31 Oct 2019 15:04:33 +0100 Subject: [PATCH] Updating demo server topic --- docs/harbor-doc-reorg/_index.md | 2 - .../install_config/installation/_index.md | 10 ++-- .../installation/demo_server.md | 48 ++++++++++++------- 3 files changed, 38 insertions(+), 22 deletions(-) diff --git a/docs/harbor-doc-reorg/_index.md b/docs/harbor-doc-reorg/_index.md index cb4a58f84..8ea4b5df1 100644 --- a/docs/harbor-doc-reorg/_index.md +++ b/docs/harbor-doc-reorg/_index.md @@ -23,8 +23,6 @@ This section describes how to install Harbor and perform the required initial co - [Configure Authentication](install_config/configuration/configure_authentication.md) - [Other General Settings](install_config/configuration/general_settings.md) -You can also use Helm to install Harbor on a Kubernetes cluster, to make it highly available. For information about installing Harbor with Helm on a Kubernetes cluster, see the [Harbor High Availability Guide](https://github.com/goharbor/harbor-helm/blob/master/docs/High%20Availability.md) in the https://github.com/goharbor/harbor-helm repository. - ## Harbor Administration This section describes how to use and maintain Harbor after deployment. These day 2 operations are performed by the Harbor Administrator. diff --git a/docs/harbor-doc-reorg/install_config/installation/_index.md b/docs/harbor-doc-reorg/install_config/installation/_index.md index 9d3cd1617..6ba783d6d 100644 --- a/docs/harbor-doc-reorg/install_config/installation/_index.md +++ b/docs/harbor-doc-reorg/install_config/installation/_index.md @@ -1,12 +1,14 @@ # Installing Harbor -This guide describes how to install and configure Harbor by using either the online or offline installer. The installation processes are almost the same. +This guide describes how to install and configure Harbor for the first time. -If you are upgrading from a previous version of Harbor, you might need to update the configuration file and migrate your data to fit the database schema of the later version. For information about upgrading, see the **[Harbor Upgrade and Migration Guide](migration_guide.md)**. +If you are upgrading from a previous version of Harbor, you might need to update the configuration file and migrate your data to fit the database schema of the later version. For information about upgrading, see the [Upgrading Harbor](../../administration/upgrade/_index.md). -In addition, the Harbor community created instructions describing how to deploy Harbor on Kubernetes. If you want to deploy Harbor to Kubernetes, see [Harbor on Kubernetes](kubernetes_deployment.md). +You can also use Helm to install Harbor on a Kubernetes cluster, to make it highly available. For information about installing Harbor with Helm on a Kubernetes cluster, see the [Harbor High Availability Guide](https://github.com/goharbor/harbor-helm/blob/master/docs/High%20Availability.md) in the https://github.com/goharbor/harbor-helm repository. -The Harbor installation process involves the following stages: +Before you install Harbor, you can test its functionality on a demo server that the Harbor team has made available. For information, see [Test Harbor with the Demo Server](demo_server.md). + +The standard Harbor installation process involves the following stages: 1. Make sure that your target host meets the [Harbor Installation Prerequisites](installation_prereqs.md). 1. [Configure HTTPS Access to Harbor](configure_https.md) diff --git a/docs/harbor-doc-reorg/install_config/installation/demo_server.md b/docs/harbor-doc-reorg/install_config/installation/demo_server.md index d7727d7fe..645695172 100644 --- a/docs/harbor-doc-reorg/install_config/installation/demo_server.md +++ b/docs/harbor-doc-reorg/install_config/installation/demo_server.md @@ -1,21 +1,37 @@ # Test Harbor with the Demo Server -**Important!** - - Please note that this demo server is **ONLY** for experimenting with functionality. - - Please **DO NOT** upload any sensitive images to this server. - - This is **NOT** a production environment and we are not responsible for any loss of data, functionality, or service. - - We will **CLEAN AND RESET** the server every **TWO Days**. - - You can only experience the non-admin functionalities on this server. Please follow the **[Installation Guide](installation_guide.md)** to set up a Harbor server to try more advanced features. - - Please do not push large images(>100MB) as the server has limited storage. +The Harbor team has made available a demo Harbor instance that you can use to experiment with Harbor and test its functionalities. -If you encounter any problems during using the demo server, please open an issue or ping us on [Slack](https://github.com/goharbor/harbor#community). +When using the demo server, please take note of the conditions of use. -**Usage** +## Conditions of Use of the Demo Server ## - - 1> The address of the demo server is [https://demo.goharbor.io](https://demo.goharbor.io) - - 2> You can register a new user by yourself - - 3> Then you can use the account/password created in step 2 to log in - ``` - docker login demo.goharbor.io - ``` -You can refer to [User Guide](user_guide.md) for more details on how to use Harbor. + - The demo server is reserved for experimental use only, to allow you to test Harbor functionality. + - Do not upload sensitive images to the demo server. + - The demo server is not a production environment. The Harbor team is not responsible for any loss of data, functionality, or service that might result from its use. + - The demo server is cleaned and reset every two days. + - The demo server only allows you to test user functionalities. You cannot test administrator functionalities. To test administrator functionalities and advanced features, set up a Harbor instance. + - Do not push images >100MB to the demo server, as it has limited storage capacity. + +If you encounter any problems while using the demo server, open an [issue on Github](https://github.com/goharbor/harbor/issues) or contact the Harbor team on [Slack](https://github.com/goharbor/harbor#community). + +## Access the Demo Server ## + +1. Go to [https://demo.goharbor.io](https://demo.goharbor.io). +1. Click **Sign up for an account**. +1. Create a user account by providing a username, your email address, your name, and a password. +1. Log in to the Harbor interface using the account you created. +1. Explore the default project, `library` and create your own project. + + For information about how to create a project, see [Managing Projects](../../working_with_projects/managing_projects.md). +1. Open a Docker client and log in to Harbor. + + ``` + docker login demo.goharbor.io + ``` +1. Build an image, tag it, and push it to a project in Harbor. + + ``` + docker push demo.goharbor.io/your-project/test-container + ``` +1. In the Harbor interface, go to the project and select the **Repositories** tab to view the image repository in the Harbor project. \ No newline at end of file