Skip to content

Commit

Permalink
Merge branch 'master' of https://github.com/layer5io/docs into fix/se…
Browse files Browse the repository at this point in the history
…archbar-click
  • Loading branch information
void-hr committed Oct 9, 2024
2 parents 4ca1760 + d34a626 commit 039ee4e
Show file tree
Hide file tree
Showing 17 changed files with 177 additions and 9 deletions.
2 changes: 1 addition & 1 deletion build/meshery-cloud.version
Original file line number Diff line number Diff line change
@@ -1 +1 @@
v0.8.25
v0.8.26
2 changes: 1 addition & 1 deletion build/meshery-extensions.version
Original file line number Diff line number Diff line change
@@ -1 +1 @@
v0.7.119-4
v0.7.121-1
19 changes: 19 additions & 0 deletions content/en/cloud/reference/releases/v0.8.26.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
---
title: v0.8.26
date: 2024-10-08T21:31:05Z
tag: v0.8.26
prerelease: false
---

## What's New
**General**
- [Sitemap] Combining sitemap exclude with robots.txt allow @leecalcote (#2823)
- Exclude few path from sitemap @sudhanshutech (#2821)
- fix sitemap generation using postbuild process @sudhanshutech (#2808)
- Upgrade kanvas snapshot action version @Aijeyomah (#2820)

## Contributors

Thank you to our contributors for making this release possible:
@Aijeyomah, @MUzairS15, @l5io, @leecalcote and @sudhanshutech

Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
67 changes: 67 additions & 0 deletions content/en/kanvas/getting-started/working-with-components.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,72 @@ aliases:
- /meshmap/getting-started/working-with-components
---

## Configuring Components

Once you’ve added components to your design in Kanvas, configuring them is a critical step in customizing and optimizing your cloud-native infrastructure. Configuring components allows you to fine-tune their behavior, set specific parameters, and ensure they meet the precise needs of your architecture.

![configuration-panel](/kanvas/getting-started/images/working-with-components/configuration-panel.png)

**Steps to Configure Components:**

1. **Select the Component:** Click on the component on the Kanvas canvas that you want to configure. This action opens the Configuration Panel.

2. **Adjust Component Settings:** In the Configuration Panel, you can modify various settings, such as resource limits, environment variables, replicas, and more, depending on the type of component you’re working with (e.g., microservices, databases).

3. **Real-time Updates:** As you adjust configurations, Kanvas will reflect those changes in real-time, allowing you to visualize how the changes affect your overall design. This feature ensures that the design is always up-to-date with the latest configurations.

By configuring components effectively, you ensure that your cloud-native deployments run smoothly and efficiently, tailored to your specific use case.

## Using the Radial Context Menu to Lock, Style, Duplicate, and Delete Components

Kanvas' **radial context menu** provides an intuitive way to interact with components on your design canvas. This menu allows you to quickly perform key actions such as locking, styling, duplicating, and deleting components without leaving the design canvas.

### Key Functions of the Radial Context Menu:

1. **Locking Components:** Locking a component ensures it stays fixed in its position on the canvas. This feature is useful when you want to prevent accidental movement of important components during collaboration or further editing. To lock a component, right-click on it to open the radial menu and select the “Lock” option.

**Use Case:** Locking is helpful when finalizing the design layout, ensuring key components remain in place even when other collaborators make adjustments.

2. **Styling Components:** The styling option allows you to modify the appearance of the component, such as changing its color or label. This feature is especially useful for visually organizing components, making it easier to distinguish between different types or states within the architecture.

**Use Case:** Style components to represent various application states, environments (production vs. development), or priority levels in your infrastructure design.

![radial-menu](/kanvas/getting-started/images/working-with-components/radial-menu.png)

3. **Duplicating Components:** The radial menu also provides a quick way to duplicate a component. This feature is beneficial when you need multiple instances of the same component with identical configurations.

**Use Case:** Quickly create replicas of services or microservices with consistent settings without having to reconfigure each one manually.

4. **Deleting Components:** Removing components is as simple as selecting the “Delete” option from the radial menu. This action helps keep the design clean and organized by removing unnecessary or outdated components.

**Use Case:** Delete components when modifying or refactoring your design to remove legacy infrastructure or redundant elements.

The radial context menu offers an efficient, user-friendly way to manage components within Kanvas, streamlining the design process.

## Annotations

Annotations in MeshMap are a powerful feature that enables you to add contextual information to your designs directly on the canvas. These annotations can take the form of comments, labels, or freehand drawings, allowing for more detailed communication and documentation throughout the design process.

### Types of Annotations:

1. **Text Annotations:** Text annotations allow you to add notes or explanations alongside components. This is useful for providing instructions, detailing configurations, or documenting key decisions made during the design process.

**Use Case:** Leave detailed instructions for collaborators about specific components or workflows within the design. Annotations are especially helpful when multiple team members are working on a project.

2. **Pencil and Pen Tool:** The whiteboard feature in MeshMap allows you to use freehand drawings to annotate the design. This is useful for highlighting connections between components, drawing attention to specific areas, or visually brainstorming ideas on the canvas.

**Use Case:** Use freehand annotations to draw attention to critical connections between services or infrastructure components, or to mark areas that require further review or adjustment.

3. **Pinning Comments to Components:** In addition to standalone annotations, you can pin comments directly to specific components. This ensures that feedback or instructions remain attached to the component, even if the design evolves or components are moved around.

**Use Case:** Pin a comment to a database component explaining the configuration and deployment strategy so that future collaborators can easily understand the logic behind it.

### Importance of Annotations:

Annotations play a crucial role in collaborative design processes. They provide a way to document decisions, share knowledge, and offer feedback directly within the design environment. This minimizes miscommunication and ensures all team members are aligned on the design's intent and structure.

By effectively using annotations, you enhance the clarity and transparency of your designs, ensuring that they are well-documented and easy for all collaborators to understand.

## Copy and Paste Components

You can copy and paste one or more components — even if you're going from one design to another.
Expand All @@ -17,6 +83,7 @@ You can copy and paste one or more components — even if you're going from one

You might be able to copy and paste with the right-click menu, but for security reasons, most browsers don't allow web apps (like Kanvas) to use your computer's clipboard through menus.

![copy-paste](/kanvas/getting-started/images/working-with-components/copy-paste.png)

To copy and paste, you can use keyboard shortcuts:

Expand Down
8 changes: 8 additions & 0 deletions content/en/kanvas/reference/releases/v0.7.120-1.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
title: v0.7.120-1
date: 2024-10-08T19:01:05Z
tag: v0.7.120-1
prerelease: false
---


8 changes: 8 additions & 0 deletions content/en/kanvas/reference/releases/v0.7.121-1.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
title: v0.7.121-1
date: 2024-10-08T21:12:33Z
tag: v0.7.121-1
prerelease: false
---


10 changes: 7 additions & 3 deletions content/en/kanvas/tasks/designs/undeploying-designs.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,13 @@ aliases:
- /meshmap/tasks/designs/undeploying-designs
---

{{% pageinfo %}}
Page under construction.
{{% /pageinfo %}}
To undeploy the resources

1. Navigate to the Actions button at the top of the Meshery Design canvas.

2. Click on the **Undeploy** icon.

![undeploying designs](/kanvas/getting-started/images/undeploying-designs/undeploy.png)

<!-- Text can be **bold**, _italic_, or ~~strikethrough~~. [Links](https://gohugo.io) should be blue with no underlines (unless hovered over).
Expand Down
48 changes: 45 additions & 3 deletions content/en/kanvas/tasks/designs/validating-designs.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,51 @@ aliases:
- /meshmap/tasks/designs/validating-designs
---

{{% pageinfo %}}
Page under construction.
{{% /pageinfo %}}
## How Validation Works

Meshery uses static analysis to verify your design. It checks all components within your design and all configured and unconfigured properties of your components against well-defined schemas based on Meshery Models.

This comprehensive validation ensures that:

1. The design adheres to the expected structure and format.

2. All components are valid and recognized by Meshery.

3. There are no missing required configurations.

## Performing Validation

1. To validate your design, navigate to the Actions button at the top of the Design canvas.

2. Click on the **Validate** Icon.

![Performing Validation](/kanvas/getting-started/images/validating-designs/performing-validation.png)

If the validation is successful, you will see a modal displaying the number of components validated and the number of annotations, similar to the one shown below:

![Successful Validation](/kanvas/getting-started/images/validating-designs/successful-validation.png)

## Handling Validation Errors

If your design fails validation checks, the modal will indicate the number of errors detected. Each error will provide specific information about the component or annotation that caused the failure. Use this detailed feedback to identify and correct the issues in your design before proceeding with the deployment.

### Validation Errors

A common validation error is:

**Missing Required Field:** This happens when a required field is not provided. For example, in the image below, the first error indicates that the field ".spec.template.spec.containers.0.env.0" must have a value.

![Validation Error](/kanvas/getting-started/images/validating-designs/validation-error.png)


To troubleshoot and remediate validation issues:

1. Click on the error on the modal.
2. This will open the configuration tab of the component that has that error.
3. Fix the configuration using the error details provided.
4. Re-run validation after any significant changes to your design to ensure all issues are resolved.

The validation process is confined to schema-based checks within Meshery and does not require communication with your target environment.

<!-- Text can be **bold**, _italic_, or ~~strikethrough~~. [Links](https://gohugo.io) should be blue with no underlines (unless hovered over).
Expand Down
22 changes: 21 additions & 1 deletion static/charts/index.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,26 @@ entries:
- charts/kratos-0.39.1.tgz
version: 0.39.1
layer5-cloud:
- apiVersion: v2
appVersion: v0.8.26
created: "2024-10-08T21:31:38.204423423Z"
dependencies:
- condition: kratos.enabled
name: kratos
repository: '@ory'
version: 0.39.1
- condition: ory/hydra.enabled
name: hydra
repository: '@ory'
version: 0.24.2
description: Layer5 Cloud is a collection of services that can be deployed on-premises.
digest: 80c192b810d5ce545a5946a95bddacfcff7e8a1a0bda4c1036ad03a0d5a30849
icon: data:image/svg+xml;base64,PHN2ZyBpZD0iTGF5ZXJfMSIgZGF0YS1uYW1lPSJMYXllciAxIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAxNDEuNzMgMTQxLjczIj48dGl0bGU+NS1saWdodC1iZzwvdGl0bGU+PHJlY3QgaWQ9Il9QYXRoXyIgZGF0YS1uYW1lPSImbHQ7UGF0aCZndDsiIHg9Ijc5LjYzIiB5PSIyMy45NyIgd2lkdGg9IjM2LjkzIiBoZWlnaHQ9IjE3Ljc5IiBzdHlsZT0iZmlsbDojMDBiMzlmIi8+PHBhdGggaWQ9Il9QYXRoXzIiIGRhdGEtbmFtZT0iJmx0O1BhdGgmZ3Q7IiBkPSJNMTE5LjkyLDgzLjlWNzYuNTNjMC04LjQ5LTcuMTQtMTUuMzctMTUuOTQtMTUuMzdINDQuMzhWNTYuMzFIMjIuNTZ2MjFIOTguMVY4My45WiIgc3R5bGU9ImZpbGw6IzAwYjM5ZiIvPjxwb2x5Z29uIGlkPSJfUGF0aF8zIiBkYXRhLW5hbWU9IiZsdDtQYXRoJmd0OyIgcG9pbnRzPSI0NC4zOCA1MC41IDQ0LjM4IDQxLjc2IDczLjYgNDEuNzYgNzMuNiAyMy45NyAyMi41NiAyMy45NyAyMi41NiA1MC41IDQ0LjM4IDUwLjUiIHN0eWxlPSJmaWxsOiMwMGQzYTkiLz48cGF0aCBpZD0iX1BhdGhfNCIgZGF0YS1uYW1lPSImbHQ7UGF0aCZndDsiIGQ9Ik05OC4xLDg5LjYyVjEwMEg2OC44OHYxNy43OWgzNmExNC43NywxNC43NywwLDAsMCwxNS0xNC40OVY4OS42MloiIHN0eWxlPSJmaWxsOiMwMGQzYTkiLz48cGF0aCBpZD0iX1BhdGhfNSIgZGF0YS1uYW1lPSImbHQ7UGF0aCZndDsiIGQ9Ik00Mi42Myw5MC41OFYxMDBINjIuODV2MTcuNzloLTI2YTE0Ljc3LDE0Ljc3LDAsMCwxLTE1LTE0LjQ5VjkwLjU4WiIgc3R5bGU9ImZpbGw6IzAwYjM5ZiIvPjwvc3ZnPg==
name: layer5-cloud
type: application
urls:
- https://docs.layer5.io/static/charts/layer5-cloud-v0.8.26.tgz
version: v0.8.26
- apiVersion: v2
appVersion: v0.8.24
created: "2024-10-05T11:36:49.079267443Z"
Expand Down Expand Up @@ -2507,4 +2527,4 @@ entries:
urls:
- https://docs.layer5.io/static/charts/layer5-cloud-0.1.0.tgz
version: 0.1.0
generated: "2024-10-05T11:36:49.074290821Z"
generated: "2024-10-08T21:31:38.197878438Z"
Binary file added static/charts/layer5-cloud-v0.8.26.tgz
Binary file not shown.

0 comments on commit 039ee4e

Please sign in to comment.