diff --git a/docs/best-practices/management-and-deployment/cloud-create/cloud-create.md b/docs/best-practices/management-and-deployment/cloud-create/cloud-create.md new file mode 100644 index 000000000..d8c681af8 --- /dev/null +++ b/docs/best-practices/management-and-deployment/cloud-create/cloud-create.md @@ -0,0 +1,117 @@ +--- +id: cloud-create +title: Cloud Create +tags: [cloud-create] +--- + +# Cloud Create +Overview +------------------------------------------------------ + +Cloud Create is a **free-to-use** Development and Management Platform, which enables cloud developers to create applications on Open Telekom Cloud **fast**. + +1. Cloud architects create applications from premade templates. +2. They can visually design and adjust the application to fit their needs. +3. An administrator deploys and updates the application on Open Telekom Cloud. +4. Cloud architects can save a design as a private template for personal use or share it public with other users. + + +[![_images/overview.png](https://docs.otc.t-systems.com/cloud-create/umn/_images/overview.png)](https://docs.otc.t-systems.com/cloud-create/umn/_images/overview.png) + +Figure 1. Overview + +:::note +* Cloud architects and administrators can be the same user. +* Deployment on Swiss Open Telekom Cloud and the function "Save & Share templates" are upcoming features. +::: + +### How cloud architects design the application + +Cloud architects can design the application from scratch or from **premade templates**: + +[![_images/overview-templates.png](https://docs.otc.t-systems.com/cloud-create/umn/_images/overview-templates.png)](https://docs.otc.t-systems.com/cloud-create/umn/_images/overview-templates.png) + +Figure 2. Select an app template to start. + +They can quickly deploy a template or start a new design from it: + +[![_images/overview-templates2.png](https://docs.otc.t-systems.com/cloud-create/umn/_images/overview-templates2.png)](https://docs.otc.t-systems.com/cloud-create/umn/_images/overview-templates2.png) + +Figure 3. Quick deploy OpenShift or Design using this template. + +Cloud Create also comes up with a visual designer for less-coding or no-coding. Developers can drag and drop the components together like lego bricks as in the following example: + +[![_images/overview-design.png](https://docs.otc.t-systems.com/cloud-create/umn/_images/overview-design.png)](https://docs.otc.t-systems.com/cloud-create/umn/_images/overview-design.png) + +Figure 4. An application example with network, compute, ansible, bash scripts, and Grafana component. + +* In the above example, the network and compute are **infrastructure** components. AnsibleTasks, Bash, and Grafana are **service** components. +* By using the Ansible and Bash components, developers can write code to execute on a compute directly. +* Grafana is an example of a ready-to-use service available in the designer. Developers can define new services and import them to the designer as well. More details on Section [How to define and import and a new service](https://docs.otc.t-systems.com/cloud-create/umn/tosca_tutorials/index.html#how-to-define-and-import-and-a-new-service). + +:::note + App templates and service components are [opensource and available on our Github](https://github.com/opentelekomcloud-blueprints/tosca-service-catalogs). +::: + +### How administrators deploy the application + +Before the deployment can start, administrators select a **Version**, provide **Inputs**, which were designed by the cloud architects, and select a cloud provider (e.g., Open Telekom Cloud) to deploy. In addition, administrators can review the auto-generated workflow before it starts. + +[![_images/overview-deploy.png](https://docs.otc.t-systems.com/cloud-create/umn/_images/overview-deploy.png)](https://docs.otc.t-systems.com/cloud-create/umn/_images/overview-deploy.png) + +Figure 5. Administrators select Open Telekom Cloud (OTC) to deploy + +During the deployment, administrators can interactively click on a workflow step and see **Terraform** is applied for the infrastructure components. For the service components, the deployment script of the service (e.g., Ansible) is applied on the target compute. + +[![_images/deployment_logs.png](https://docs.otc.t-systems.com/cloud-create/umn/_images/deployment_logs.png)](https://docs.otc.t-systems.com/cloud-create/umn/_images/deployment_logs.png) + +Figure 6. An example Terraform is generated and applied for a Compute + +Why Cloud Create? +----------------------------------------------------------------------- + +The following table shows the differences between the Web console / other tools and Cloud Create: + +[![_images/features_compare.png](https://docs.otc.t-systems.com/cloud-create/umn/_images/features_compare.png)](https://docs.otc.t-systems.com/cloud-create/umn/_images/features_compare.png) + +Figure 7. Features comparison + +Both the Web console and Cloud Create can deploy one cloud service. However, an application nowadays consists of multiple cloud services but not just one. Furthermore, each application has individual needs to adapt to the cloud differently. The Web console can bring up one service up and running separately but cannot automate an application with multiple services. + +With Cloud Create, after creating an application from a template, you can modify the application to fit your individual needs. For example, one of our customer used Cloud Create to create their application from the OpenShift template, then they added a worker node with the GPU capability and wrote an Ansible script to deploy packages on the bastion host, etc. The given example shows that the modification can happen in every corner, from the cloud infrastructure to the software layer of your application. Finally, you can run update between versions on operation day 2 as well. To update between versions, Cloud Create auto-calculates the differences between the two versions and auto-generates the update workflow steps from one version to other one. + +New features +-------------------------------------------------------------- + +### OpenShift template (v2.13) + +Users can create a [Self-managed OpenShift Container Platform](https://www.redhat.com/en/technologies/cloud-computing/openshift/container-platform) on Open Telekom Cloud from the [OpenShift template](https://docs.otc.t-systems.com/cloud-create/umn/service_catalogs/openshift.html#openshift). + +FAQ +-------------------------------------------- + +### What are the differences between Cloud Create and the Web console + +With the [Web console](https://console.otc.t-systems.com/), users can only create the cloud infrastructure manually. It means, they can create a network, a storage, a VM separately but without automation. + +On the other hand, Cloud Create enables developers to design and automate the deployment of the whole application including the cloud infrastructure and services. In addition, developers can design the application in various versions and run update between them. Finally, Cloud Create provides premade templates (e.g., OpenShift) to re-use and extend. + +### How can I login in to Cloud Create + +You can log in to Cloud Create using an IAM user account with the **Tenant Administrator** role. This is the same credentials when you log in to the web console, **not the ICU account**. + +If you do not have a user account in the IAM, see [How to create a user account & login](https://docs.otc.t-systems.com/cloud-create/umn/register.html#how-to-login). + +### Which components are supported + +An overview of all supported components is available in Section [Components overview](https://docs.otc.t-systems.com/cloud-create/umn/components_overview.html#components-overview). + +### Is Cloud Create opensource + +Cloud Create is based on two opensource projects Application Lifecycle Enablement for Cloud (Alien4cloud) and Ystia Orchestrator (Yorc). At Open Telekom Cloud, we further integrate it with OpenStack and Google Cloud, provide an easy-to-use UI, added features (e.g., secrets management, deployment update, OpenShift template, etc.), and enforce the strictest Privacy and Security Assessment (PSA) process of Deutsche Telekom. + +All premade templates and service components are opensource and available on [our Github](https://github.com/opentelekomcloud-blueprints/tosca-service-catalogs). You can create pull requests to add more components and fix bugs. + +### Which Terraform version do you use + +We use Terraform 1.5.4 under the Mozilla Public License v2.0 (MPL 2.0). \ No newline at end of file diff --git a/docs/best-practices/management-and-deployment/cloud-create/google-cloud/application-dynamic-subnets.md b/docs/best-practices/management-and-deployment/cloud-create/google-cloud/application-dynamic-subnets.md index 41e193c05..7701c1559 100644 --- a/docs/best-practices/management-and-deployment/cloud-create/google-cloud/application-dynamic-subnets.md +++ b/docs/best-practices/management-and-deployment/cloud-create/google-cloud/application-dynamic-subnets.md @@ -1,9 +1,10 @@ --- id: application-dynamic-subnets -title: Design your application with dynamic subnets +title: Design with dynamic subnets +tags: [multi-cloud, google, gcp, cloud-create] --- -# Design your application with dynamic subnets +# Design with dynamic subnets The Section [Design your application with static subnets in multiple regions](https://docs.otc.t-systems.com/cloud-create/umn/google/multi_regions.html#google-static-subnets) shows how to define multiple subnets for a network **explicitly**. However, users may not want to define the subnets explicitly. In such a case, the Cloud Create will auto-generate one subnet for each region dynamically as follows: Design diff --git a/docs/best-practices/management-and-deployment/cloud-create/google-cloud/google-deploy.md b/docs/best-practices/management-and-deployment/cloud-create/google-cloud/google-deploy.md index 456d38544..e66dccb5c 100644 --- a/docs/best-practices/management-and-deployment/cloud-create/google-cloud/google-deploy.md +++ b/docs/best-practices/management-and-deployment/cloud-create/google-cloud/google-deploy.md @@ -1,6 +1,7 @@ --- id: google-deploy title: How to deploy your application on Google Cloud +tags: [multi-cloud, google, gcp, cloud-create] --- # How to deploy your application on Google Cloud diff --git a/docs/best-practices/management-and-deployment/cloud-create/google-cloud/google.md b/docs/best-practices/management-and-deployment/cloud-create/google-cloud/google.md index d4a9819a5..edc670519 100644 --- a/docs/best-practices/management-and-deployment/cloud-create/google-cloud/google.md +++ b/docs/best-practices/management-and-deployment/cloud-create/google-cloud/google.md @@ -1,6 +1,7 @@ --- id: google title: Multicloud Google Cloud +tags: [multi-cloud, google, gcp, cloud-create] --- # Multicloud: Google Cloud diff --git a/docs/best-practices/management-and-deployment/cloud-create/google-cloud/multi-region.md b/docs/best-practices/management-and-deployment/cloud-create/google-cloud/multi-region.md index 1e5cf6b49..208de6f26 100644 --- a/docs/best-practices/management-and-deployment/cloud-create/google-cloud/multi-region.md +++ b/docs/best-practices/management-and-deployment/cloud-create/google-cloud/multi-region.md @@ -1,9 +1,10 @@ --- id: multi-region -title: Design your application with static subnets in multiple regions +title: Design with static subnets in multiple regions +tags: [multi-cloud, google, gcp, cloud-create] --- -# Design your application with static subnets in multiple regions +# Design with static subnets in multiple regions The following tutorial describes how to design an application with one (global) private network spanning in two regions of Google Cloud. Each region has one subnet and one compute connecting to the subnet (e.g., `Compute` connects to `Subnet`, `Compute_2` connects to `Subnet_2`). The compute in the first region (e.g., `Compute`) has access to the internet. [![../_images/multi-regions.png](https://docs.otc.t-systems.com/cloud-create/umn/_images/multi-regions.png)](https://docs.otc.t-systems.com/cloud-create/umn/_images/multi-regions.png) diff --git a/docs/best-practices/management-and-deployment/cloud-create/service-catalogs/openshift-template.md b/docs/best-practices/management-and-deployment/cloud-create/service-catalogs/openshift-template.md index b34b0ebde..f149f3ed7 100644 --- a/docs/best-practices/management-and-deployment/cloud-create/service-catalogs/openshift-template.md +++ b/docs/best-practices/management-and-deployment/cloud-create/service-catalogs/openshift-template.md @@ -8,8 +8,6 @@ last_update: --- # OpenShift Template -About ------------------------------------------------- The following tutorial shows you how to register a (trial) subscription key from Red Hat and uses it to create an OpenShift cluster using the OpenShift template. @@ -27,7 +25,7 @@ How to use 1. Create a new application using the template **OpenShift** or **OpenShift HA** with a selected version (e.g., 4.13.19) 2. Go to **Quick Deploy**. -### Deloy Setup +### Deploy Setup #### Specify base\_domain diff --git a/docs/best-practices/management-and-deployment/cloud-create/service-catalogs/service-catalogs.md b/docs/best-practices/management-and-deployment/cloud-create/service-catalogs/service-catalogs.md new file mode 100644 index 000000000..c9493b423 --- /dev/null +++ b/docs/best-practices/management-and-deployment/cloud-create/service-catalogs/service-catalogs.md @@ -0,0 +1,12 @@ +--- +id: service-catalogs +title: Service catalogs +tags: [cloud-create] +--- + +# Service catalogs +In addition to infrastructure components (e.g., compute, network, storage), Cloud Create provides most frequently used services on the application layer that are ready-to-deploy (e.g., Prometheus for monitoring). This section shows how to use these services in the editor. + +The service catalogs are modelled using TOSCA (i.e., a YAML file definition of the service). They are open-source and available at [the service catalogs of Open Telekom Cloud](https://github.com/opentelekomcloud-blueprints/tosca-service-catalogs). + +A part from the services provided by Cloud Create, users can also model their services using TOSCA, then import them in the designer and share with one another. For tutorials how to model the service using TOSCA, refer to [How to define a service catalog](https://docs.otc.t-systems.com/cloud-create/umn/tosca_tutorials/define.html#tosca-define-service-catalog). \ No newline at end of file diff --git a/docusaurus.config.ts b/docusaurus.config.ts index 301a262e2..08543a5e6 100644 --- a/docusaurus.config.ts +++ b/docusaurus.config.ts @@ -37,8 +37,9 @@ const config: Config = { docs: { sidebarPath: './sidebars.ts', editUrl:'https://github.com/akyriako/docs-next/tree/main/', - showLastUpdateAuthor: true, - showLastUpdateTime: true, + // showLastUpdateAuthor: true, + // showLastUpdateTime: true, + breadcrumbs: true }, theme: { @@ -60,7 +61,7 @@ const config: Config = { themes: ['docusaurus-theme-search-typesense'], themeConfig: { // Replace with your project's social card - image: 'img/docusaurus-social-card.jpg', + image: 'img/open-telekom-cloud-social-card.png', navbar: { // title: 't', logo: { diff --git a/sidebars.ts b/sidebars.ts index cda211397..c7eb53a38 100644 --- a/sidebars.ts +++ b/sidebars.ts @@ -369,15 +369,19 @@ const sidebars: SidebarsConfig = { { type: 'category', label: 'Cloud Create 🔥', + link: { + type: 'doc', + id: 'best-practices/management-and-deployment/cloud-create/cloud-create' + }, items: [ { type: 'category', label: 'Google Cloud', + link: { + type: 'doc', + id: 'best-practices/management-and-deployment/cloud-create/google-cloud/google', + }, items: [ - { - type: 'doc', - id: 'best-practices/management-and-deployment/cloud-create/google-cloud/google', - }, { type: 'doc', id: 'best-practices/management-and-deployment/cloud-create/google-cloud/google-deploy', @@ -394,7 +398,17 @@ const sidebars: SidebarsConfig = { }, { type: 'category', - label: 'Service Catalogs', + label: 'Service catalogs', + // link: { + // type: 'generated-index', + // description: 'Learn about the most important Docusaurus concepts!', + // slug: '/best-practices/management-and-deployment/cloud-create/service-catalogs', + // keywords: ['cloud-create'], + // }, + link: { + type: 'doc', + id: 'best-practices/management-and-deployment/cloud-create/service-catalogs/service-catalogs' + }, items: [ { type: 'doc', diff --git a/static/img/open-telekom-cloud-social-card.png b/static/img/open-telekom-cloud-social-card.png new file mode 100644 index 000000000..ea4e37553 Binary files /dev/null and b/static/img/open-telekom-cloud-social-card.png differ