Skip to content

Commit

Permalink
Updated readmesConfig.json to get latest version of documentation
Browse files Browse the repository at this point in the history
Updated widgets' README.md files
  • Loading branch information
qooban committed Nov 20, 2018
1 parent 68c663d commit af2dc5b
Show file tree
Hide file tree
Showing 42 changed files with 122 additions and 90 deletions.
4 changes: 2 additions & 2 deletions scripts/readmesConfig.json
@@ -1,6 +1,6 @@
{
"linksBasePath": "https://docs.cloudify.co/4.5.0",
"rawContentBasePath": "https://raw.githubusercontent.com/cloudify-cosmo/docs.getcloudify.org/4.5.0-build",
"linksBasePath": "https://docs.cloudify.co/staging/dev",
"rawContentBasePath": "https://raw.githubusercontent.com/cloudify-cosmo/docs.getcloudify.org/master",
"files": [
{"widget": "agents", "link": "/content/working_with/console/widgets/agents.md"},
{"widget": "blueprintActionButtons", "link": "/content/working_with/console/widgets/blueprintActionButtons.md"},
Expand Down
26 changes: 26 additions & 0 deletions widgets/agents/README.md
@@ -0,0 +1,26 @@
### Agents Management
Displays the following information about a specific agent:

* **Id** - unique identifier of the agent
* **IP** - IP address of the agent host
* **Deployment** - Deployment ID associated with agent
* **Node** - Node ID associated with agent
* **System** - agent host operation system
* **Version** - agent version
* **Install Method** - agent installation method (one of described [here](https://docs.cloudify.co/staging/dev/install_maintain/agents/installation))

![agents-management](https://docs.cloudify.co/staging/dev/images/ui/widgets/agents-management.png)

By clicking buttons above the table you can execute the following operations:

* `Install` - executes `install_new_agents` workflow on selected deployment. Allows to define Manager IP, Manager Certificate, stop old agents and filter by node(s), node instance(s) and install method(s).
* `Validate` - executes `validate_agents` workflow on selected deployment. Allows to filter by node(s), node instance(s) and install method(s).

You can find more about agents [here](https://docs.cloudify.co/staging/dev/install_maintain/agents/index.html).


#### Widget Settings

* `Refresh time interval` - The time interval in which the widget’s data will be refreshed, in seconds. Default: 15 seconds
* `List of fields to show in the table` - List of columns to be shown in list of agents table. Some of the fields may be hidden depending on the context, eg. when Deployment ID is set in context then Deployment field will be hidden.
* `Filter Agents by Install Method` - Install Methods to filter Agents. Unset all options to disable this type of filtering. Default: No filtering by Install Methods.
2 changes: 1 addition & 1 deletion widgets/blueprintActionButtons/README.md
Expand Up @@ -5,7 +5,7 @@ The action buttons need to receive the id of the desired blueprint. This can be
* By placing the buttons in a blueprint’s drill-down page, meaning the blueprint has been selected before entering the page, and its id is included in the page’s context.
* By adding to the page a widget allowing to select blueprints, such as the resources filter or the blueprints list.

![blueprint-actions](https://docs.cloudify.co/4.5.0/images/ui/widgets/blueprint-action-buttons.png)
![blueprint-actions](https://docs.cloudify.co/staging/dev/images/ui/widgets/blueprint-action-buttons.png)

#### Widget Settings
None
2 changes: 1 addition & 1 deletion widgets/blueprintCatalog/README.md
Expand Up @@ -5,7 +5,7 @@ By default, the widget presents the blueprints under cloudify-examples repositor
You can filter the presented blueprints by creating a filter query in the widget’s settings.
You can and should enter Github credentials for fetching data, as the defaults used by the widgets can reach the restricted query limit of GitHub (~50) . These parameters are pulled from secrets) as the github-username and github-password keys. These parameters are a must if you want to configure the widget to access private repositories.

![blueprints-catalog](https://docs.cloudify.co/4.5.0/images/ui/widgets/blueprints-catalog.png)
![blueprints-catalog](https://docs.cloudify.co/staging/dev/images/ui/widgets/blueprints-catalog.png)

#### Widget Settings
* `Blueprint Examples URL` - Specifies the json file from which the Cloudify examples URLs are being read
Expand Down
2 changes: 1 addition & 1 deletion widgets/blueprintInfo/README.md
Expand Up @@ -9,7 +9,7 @@ Displays the following information about a specific blueprint:
* **Creator user-name**
* **Main blueprint file name** (as the blueprint archive can contain multiple files)

![blueprint-info](https://docs.cloudify.co/4.5.0/images/ui/widgets/blueprint-info.png)
![blueprint-info](https://docs.cloudify.co/staging/dev/images/ui/widgets/blueprint-info.png)

#### Widget Settings
* `Refresh time interval` - The time interval in which the widget’s data will be refreshed, in seconds. Default: 10 seconds
Expand Down
2 changes: 1 addition & 1 deletion widgets/blueprintNum/README.md
Expand Up @@ -2,7 +2,7 @@
Displays the total number of blueprints in the tenant, according to the user’s permissions and the blueprints’ visibility levels.
The widget is clickable, and upon clicking will redirect by default to the “Local Blueprint” page. You can set the widget’s configuration to lead to a different page.

![number_of_blueprints](https://docs.cloudify.co/4.5.0/images/ui/widgets/num_of_blueprints.png)
![number_of_blueprints](https://docs.cloudify.co/staging/dev/images/ui/widgets/num_of_blueprints.png)

#### Widget Settings
* `Refresh time interval` - The time interval in which the widget’s data will be refreshed, in seconds. Default: 10 seconds.
Expand Down
2 changes: 1 addition & 1 deletion widgets/blueprintSources/README.md
@@ -1,7 +1,7 @@
### Blueprint Sources
Displays all the source files in a blueprint package in tree view, adjacent to the code. When you click an item in the tree, its code is displayed in the code panel. You can also open the file in full mode by clicking on the gray box presenting its name in the top right corner of the widget.

![blueprint-sources](https://docs.cloudify.co/4.5.0/images/ui/widgets/blueprint-sources.png)
![blueprint-sources](https://docs.cloudify.co/staging/dev/images/ui/widgets/blueprint-sources.png)

#### Widget Settings
* `Content pane initial width in %` - sets the default size of the source part of the window in percent of screen width. Default: 65%.
2 changes: 1 addition & 1 deletion widgets/blueprintUploadButton/README.md
@@ -1,7 +1,7 @@
### Blueprint upload button
This Button allows uploading a blueprint to the manager. Clicking on it opens a dialog for providing the following details:

* **Blueprint visibility** - represented by a colourful icon, and can be set by clicking on it. See [resource’s visibility](https://docs.cloudify.co/4.5.0/working_with/manager/resource-visibility). Default: tenant
* **Blueprint visibility** - represented by a colourful icon, and can be set by clicking on it. See [resource’s visibility](https://docs.cloudify.co/staging/dev/working_with/manager/resource-visibility). Default: tenant
* **Blueprint archive path** (local or URL)
* **Name** to identify the blueprint on the manager (“Blueprint name”).
* **Main .yaml file in the blueprint archive** (“Blueprint filename”). Default: blueprint.yaml
Expand Down
2 changes: 1 addition & 1 deletion widgets/blueprints/README.md
Expand Up @@ -11,7 +11,7 @@ Displays all the blueprints on the tenant, according to the user’s permissions
* **Main blueprint file name** (as the blueprint archive can contain multiple files)
* **Number of deployments derived from the blueprint**

![blueprints-list](https://docs.cloudify.co/4.5.0/images/ui/widgets/blueprints-list.png)
![blueprints-list](https://docs.cloudify.co/staging/dev/images/ui/widgets/blueprints-list.png)

#### Widget Settings
* `Refresh time interval` - The time interval in which the widget’s data will be refreshed, in seconds. Default: 10 seconds
Expand Down
2 changes: 1 addition & 1 deletion widgets/buttonLink/README.md
@@ -1,7 +1,7 @@
### Button link
Opens the specified URL in a separate tab. You can define the label that appears on the button

![button-link](https://docs.cloudify.co/4.5.0/images/ui/widgets/button-link.png)
![button-link](https://docs.cloudify.co/staging/dev/images/ui/widgets/button-link.png)

#### Widget Settings
* `Button label` - The text to appear on the button
Expand Down
4 changes: 2 additions & 2 deletions widgets/composerLink/README.md
@@ -1,9 +1,9 @@
### Composer link
Opens the Cloudify Composer, which allows creating blueprints with a graphical drag-and-drop tool. The Composer comes as part of the Cloudify Premium edition, and is only available for users with certain roles.

For more information regarding the Composer, see [Cloudify Composer](https://docs.cloudify.co/4.5.0/developer/composer/index.html).
For more information regarding the Composer, see [Cloudify Composer](https://docs.cloudify.co/staging/dev/developer/composer/index.html).

![Composer-link](https://docs.cloudify.co/4.5.0/images/ui/widgets/composer-link.png)
![Composer-link](https://docs.cloudify.co/staging/dev/images/ui/widgets/composer-link.png)

#### Widget Settings
None
2 changes: 1 addition & 1 deletion widgets/deploymentActionButtons/README.md
Expand Up @@ -4,7 +4,7 @@ Buttons which allow running workflows of a specific deployment, updating it or d
* By placing the deployment action buttons in the deployments drill-down page, meaning the deployment has been selected before entering the page, and its id is included in the page’s context.
* By adding to the page a widget allowing to select deployments, such as the resources filter or the blueprint deployments

![deployment-action-buttons.png](https://docs.cloudify.co/4.5.0/images/ui/widgets/deployment-action-buttons.png)
![deployment-action-buttons.png](https://docs.cloudify.co/staging/dev/images/ui/widgets/deployment-action-buttons.png)

#### Widget Settings
None
2 changes: 1 addition & 1 deletion widgets/deploymentButton/README.md
@@ -1,7 +1,7 @@
### Create deployment button
Allows creating a deployment of a chosen blueprint. After choosing a name for the deployment, the desired blueprint and the visibility of the deployment (private/tenant), a screen will open, allowing to specify values for the inputs required by the chosen blueprint.

![create_deployment_button](https://docs.cloudify.co/4.5.0/images/ui/widgets/create_deployment_button.png)
![create_deployment_button](https://docs.cloudify.co/staging/dev/images/ui/widgets/create_deployment_button.png)


#### Widget Settings
Expand Down
2 changes: 1 addition & 1 deletion widgets/deploymentNum/README.md
Expand Up @@ -2,7 +2,7 @@
Displays the total number of deployments in the tenant, according to the user’s permissions and the blueprints’ visibility levels.
The widget is clickable, and upon clicking will redirect by default to the “Deployments” page. You can set the widget’s configuration to lead to a different page.

![number_of_deployments](https://docs.cloudify.co/4.5.0/images/ui/widgets/num_of_deployments.png)
![number_of_deployments](https://docs.cloudify.co/staging/dev/images/ui/widgets/num_of_deployments.png)

#### Widget Settings
* `Refresh time interval` - The time interval in which the widget’s data will be refreshed, in seconds. Default: 10 seconds.
Expand Down
16 changes: 8 additions & 8 deletions widgets/deploymentWizardButtons/README.md
@@ -1,21 +1,21 @@
### Deployment wizard buttons
Allows installing a deployment of a Hello World example or chosen blueprint.

![deployment_wizard_buttons](https://docs.cloudify.co/4.5.0/images/ui/widgets/deployment_wizard_buttons.png)
![deployment_wizard_buttons](https://docs.cloudify.co/staging/dev/images/ui/widgets/deployment_wizard_buttons.png)

After clicking on one of the buttons user is guided step by step through the process from selecting blueprint, through providing necessary data - plugins, secrets and inputs, to running install workflow.

Details about the steps in wizard are described below.

##### Infrastructure step (only in Hello World Wizard)
![hw_wizard_0](https://docs.cloudify.co/4.5.0/images/ui/widgets/deployment_wizard_buttons_hw_wizard_0.png)
![hw_wizard_0](https://docs.cloudify.co/staging/dev/images/ui/widgets/deployment_wizard_buttons_hw_wizard_0.png)

In the first step Hello World blueprint is already selected from Cloudify blueprint examples. You just need to select the type of the infrastracture you want to deploy that example on.

Click `Next` button to go the next step.

##### Blueprint step (only in Deployment Wizard)
![deployment_wizard_0](https://docs.cloudify.co/4.5.0/images/ui/widgets/deployment_wizard_buttons_deployment_wizard_0.png)
![deployment_wizard_0](https://docs.cloudify.co/staging/dev/images/ui/widgets/deployment_wizard_buttons_deployment_wizard_0.png)

In the first step you need to provide blueprint package (either by URL or local archive file), set blueprint name and choose the YAML file from the blueprint package.

Expand All @@ -26,7 +26,7 @@ Click `Next` button to go the next step.
##### Plugins step
In this step you see list of plugins detected in blueprint's YAML file imports section.

![wizard_plugins_step](https://docs.cloudify.co/4.5.0/images/ui/widgets/deployment_wizard_buttons_hw_wizard_plugins.png)
![wizard_plugins_step](https://docs.cloudify.co/staging/dev/images/ui/widgets/deployment_wizard_buttons_hw_wizard_plugins.png)

Some of them may be automatically installed, for some of them you will need to provide wagon and plugin YAML files. You can also add your plugin if it was not detected.

Expand All @@ -35,7 +35,7 @@ Hover over icon in `Action` column to see details and check if you need to provi
##### Secrets step
In this step you see list of secrets detected in blueprint's YAML file.

![wizard_secrets_step](https://docs.cloudify.co/4.5.0/images/ui/widgets/deployment_wizard_buttons_hw_wizard_secrets.png)
![wizard_secrets_step](https://docs.cloudify.co/staging/dev/images/ui/widgets/deployment_wizard_buttons_hw_wizard_secrets.png)

Some of them may already be set, for some of them you will need to provide values.

Expand All @@ -44,7 +44,7 @@ Hover over icon in `Action` column to see details and check if you need to provi
##### Inputs step
In this step you see list of blueprint inputs.

![wizard_inputs_step](https://docs.cloudify.co/4.5.0/images/ui/widgets/deployment_wizard_buttons_hw_wizard_inputs.png)
![wizard_inputs_step](https://docs.cloudify.co/staging/dev/images/ui/widgets/deployment_wizard_buttons_hw_wizard_inputs.png)

If input has default value you won't need to provide it. You need to set values only for inputs which does not have default values.

Expand All @@ -53,14 +53,14 @@ Hover over icon in `Action` column to see details and check if you need to provi
##### Confirm step
In this step you see list of task to be performed during installation process.

![wizard_confirm_step](https://docs.cloudify.co/4.5.0/images/ui/widgets/deployment_wizard_buttons_hw_wizard_confirm.png)
![wizard_confirm_step](https://docs.cloudify.co/staging/dev/images/ui/widgets/deployment_wizard_buttons_hw_wizard_confirm.png)

Click `Install` to start resources installation procedure or click `Back` button to go to the previous steps.

##### Install step
In this step you see list of ongoing tasks and its status.

![wizard_install_step](https://docs.cloudify.co/4.5.0/images/ui/widgets/deployment_wizard_buttons_hw_wizard_install.png)
![wizard_install_step](https://docs.cloudify.co/staging/dev/images/ui/widgets/deployment_wizard_buttons_hw_wizard_install.png)

When deployment installation starts successfuly you can perform additional actions - install another blueprint or go to deployment page.

Expand Down
9 changes: 5 additions & 4 deletions widgets/deployments/README.md
@@ -1,10 +1,11 @@
### Blueprint deployments
Displays the list of the deployments in the current tenant, according to the user’s permissions. The data can be displayed as a table or list. In the case of a list view, the status of each deployment is also displayed. For information about deployment status, [click here](https://docs.cloudify.co/4.5.0/working_with/console/deployments-page)
Displays the list of the deployments in the current tenant, according to the user’s permissions. The data can be displayed as a table or list. In the case of a list view, the status of each deployment is also displayed. For information about deployment status, [click here](https://docs.cloudify.co/staging/dev/working_with/console/deployments-page)

![blueprint-deployments](https://docs.cloudify.co/4.5.0/images/ui/widgets/blueprint-deployments.png)
![blueprint-deployments](https://docs.cloudify.co/staging/dev/images/ui/widgets/blueprint-deployments.png)

#### Widget Settings
* `Refresh time interval` - The time interval in which the widget’s data will be refreshed, in seconds. Default: 10 seconds
* `Enable click to drill down` - This option enables redirecting to the deployment’s drill down page upon clicking on a specific deployments. Default: True
* `Blueprint ID to filter by` - TAllows filtering the deployments in this list to those derived from a specific blueprint, by providing its ID (the blueprint ID is its name). Default: empty
* `Enable click to drill down` - This option enables redirecting to the deployment’s drill down page upon clicking on a specific deployments. Default: On
* `Show execution status label` - Allows showing last execution workflow ID and status near last execution status icon. Default: Off
* `Blueprint ID to filter by` - Allows filtering the deployments in this list to those derived from a specific blueprint, by providing its ID (the blueprint ID is its name). Default: empty
* `Display style` - Can be either list or table. The deployments status column is only available in list mode. Default: List
12 changes: 7 additions & 5 deletions widgets/events/README.md
@@ -1,22 +1,24 @@
### Events and Logs
Displays the logs and events of all the executions in the current tenant, according to the user’s permissions. You can configure the fields that are displayed and can choose to indicate in colors success and failure messages.

![events-logs](https://docs.cloudify.co/4.5.0/images/ui/widgets/events-logs-2.png)
![events-logs](https://docs.cloudify.co/staging/dev/images/ui/widgets/events-logs-2.png)

#### Widget Settings
* `Refresh time interval` - The time interval in which the widget’s data will be refreshed, in seconds. Default: 2 seconds
* `List of fields to show in the table` You can choose which fields to present. By default, these are the fields presented:
* `List of fields to show in the table` - You can choose which fields to present. By default, these are the fields presented:

* Icon
* Timestamp
* Blueprint
* Deployment
* Node Id
* Node Instance Id
* Workflow
* Operation
* Node Name
* Node Id
* Message

You can also choose to add the field “Type”, which will present the log level in case of a log, and event type in case of an event.

* `Color message based on type` - when marked as “on”, successful events will be coloured in blue, and failures in red. Default: On
* `Maximum message length before truncation`- Allow to define the length of the messages presented in the table. Default: 200. Please note that even if the message is being truncated in the table itself, you can see the full message upon overing.

* `Maximum message length before truncation` - Allow to define the length of the messages presented in the table. Default: 200. Please note that even if the message is being truncated in the table itself, you can see the full message upon overing.
18 changes: 9 additions & 9 deletions widgets/eventsFilter/README.md
@@ -1,15 +1,15 @@
### Events and Logs Filter
Displays a filter pane for events and logs. The following filtering options are available:

* **Type:** Logs/Events
* **Blueprint** (multiple selection available)
* **Deployment** (multiple selection available)
* **Event Type** In case of “Type” was selected as event (Workflow started, Task sent, Task started, Task ended successfully,Workflow ended successfully, Workflow staged, Workflow node event, Task failed, Workflow failed, Task rescheduled)
* **Log Levels** In case “Type” was selected as log (Debug, Info, Warning. Error, Critical)
* **Message text**
* **Time Filter**
* **Type** - Logs/Events
* **Event Types** - predefined event types: Policy end successfully started, Policy failed, Processing trigger, Task ended successfully, Task failed, Task received, Task rescheduled, Task retried, Task sent, Task started, Trigger failed, Trigger succeeded, Workflow cancelled, Workflow ended successfully, Workflow event, Workflow failed, Workflow initializing node, Workflow initializing policies, Workflow node event, Workflow received, Workflow staged, Workflow started.
You can also specify your log level by typing in text. Multiselection available.
* **Log Levels** - predefined log levels: Debug, Info, Warning. Error, Critical.
You can also specify your log level by typing in text. Multiselection available.
* **Message Text** - part of log/event message
* **Time Range** - time range to get log/events

![events-logs-filter](https://docs.cloudify.co/4.5.0/images/ui/widgets/events-logs-filter.png)
![events-logs-filter](https://docs.cloudify.co/staging/dev/images/ui/widgets/events-logs-filter.png)

#### Widget Settings
* `Refresh time interval` - The time interval in which the widget’s data will be refreshed, in seconds. Default: 10 seconds
None

0 comments on commit af2dc5b

Please sign in to comment.