Skip to content

Commit 697cbe7

Browse files
committed
Started using img shortcodes in getting started tutorial part 3
Signed-off-by: Ole Herman Schumacher Elgesem <ole@northern.tech>
1 parent 70e9562 commit 697cbe7

1 file changed

Lines changed: 18 additions & 18 deletions

File tree

content/getting-started/03-adding-modules.markdown

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ CFEngine Build enables users to find useful modules on the website, [build.cfeng
1313

1414
The workflow will look like this:
1515

16-
![](workflow.png)
16+
{{< wideimg "workflow.png" "Infographic showing 4 steps of the CFEngine Build workflow, adding modules, building, deploying, observing." >}}
1717

1818
You can work on CFEngine Build projects both from inside Mission Portal, and using our command line tools.
1919
In this tutorial, we will do it from inside Mission Portal.
@@ -22,11 +22,11 @@ In this tutorial, we will do it from inside Mission Portal.
2222

2323
When you are logged in to Mission Portal, click the **Build** application in the left menu.
2424

25-
![](click-build.png)
25+
{{< wideimg "click-build.png" "Screenshot of Mission Portal showing the Build application you should click highlighted." >}}
2626

2727
If you do not have any pre-existing Build projects, you will be automatically prompted to create a new one:
2828

29-
![](add-new-project.png)
29+
{{< wideimg "add-new-project.png" "Screenshot of the form to add a new project with git repository information and the set up later button highlighted." >}}
3030

3131
On this screen, you can enter details to make your project be synced with a git repository (for example on github.com).
3232
At this point, since we are just testing things, feel free to just click **Set up later**.
@@ -35,31 +35,31 @@ You will be prompted to select a version of the masterfiles policy framework (th
3535
In general, the default is the best option, it will choose a version matching the version of CFEngine you are running.
3636
Click **Confirm**.
3737

38-
![](masterfiles-selection.png)
38+
{{< img "masterfiles-selection.png" "Small popup which allows you to choose between maserfiles version 3.27.1 (default) and master" >}}
3939

4040
## Step 1: Explore and add modules
4141

4242
You will see a welcome screen which gives you an introduction to CFEngine Build:
4343

44-
![](cfengine-build-welcome.png)
44+
{{< wideimg "cfengine-build-welcome.png" "Screenshot of Mission Portal Build welcome screen with instructions of how to get started and search field for finding modules." >}}
4545

4646
The search bar here searches for modules from [build.cfengine.com](https://build.cfengine.com).
4747
Let's add some modules;
4848

4949
Search for `compliance-report-lynis` and click on the search result;
5050

51-
![](search-compliance-report-lynis.png)
51+
{{< wideimg "search-compliance-report-lynis.png" "Search results for compliance-report-lynis, there is one result that module." >}}
5252

5353
Click **Add module** to add it to your project:
5454

55-
![](add-compliance-report-lynis.png)
55+
{{< wideimg "add-compliance-report-lynis.png" "Module description screen after clicking the module, with the add module button highlighted." >}}
5656

5757
Feel free to add more modules, for example search for `inventory` and add `inventory-etc-hosts`, or any other module which seems useful.
5858
Generally, `inventory-` modules add useful information to the reporting inventory and don't require any configuration or input to work.
5959

6060
On the left side of the application we can see the modules we've added:
6161

62-
![](added-modules.png)
62+
{{< wideimg "added-modules.png" "Screenshot of Build in Mission Portal, with the added modules section highlighted showing the modules we've added." >}}
6363

6464
## Step 2 & 3: Build & deploy
6565

@@ -71,48 +71,48 @@ In order to get these modules actually running, a few things need to happen:
7171

7272
In Mission Portal, we achieve this by simply clicking the **Deploy locally** button in the top right corner:
7373

74-
![](deploy-locally.png)
74+
{{< wideimg "deploy-locally.png" "Screenshot of Build in Mission Portal UI with the Deploy locally button highlighted." >}}
7575

7676
## Step 4: Observe
7777

7878
Now, our modules are running on the hub and any other hosts in the infrastructure, and new reporting data will start arriving.
7979
Let's open the **Reports** application:
8080

81-
![](navigate-reports.png)
81+
{{< wideimg "navigate-reports.png" "Screenshot of Mission Portal with the left navigation button for reports highlighted." >}}
8282

8383
Go to the **CFEngine Build** tab to find reports added by CFEngine Build modules:
8484

85-
![](reports-cfengine-build-tab.png)
85+
{{< wideimg "reports-cfengine-build-tab.png" "Screenshot of the Reports application with the CFEngine Build tab highlighted." >}}
8686

8787
And click on the new Lynis report:
8888

89-
![](reports-click-lynis.png)
89+
{{< wideimg "reports-click-lynis.png" "Screenshot of the report application after clicking the CFEngine Build tab. There is only one report shown and highlighted, the lynis report." >}}
9090

9191
You will now see the new report and its results:
9292

93-
![](lynis-compliance-report.png)
93+
{{< wideimg "lynis-compliance-report.png" "Overview of the results from the Lynis compliance report, showing percentages in different categories and individual lynis security hardening check results." >}}
9494

9595
In this case, you can scroll through the report, look at the failing checks and find potential security hardening improvements highlighted by Lynis.
9696
The other module we added, `inventory-etc-hosts`, does not add a _report_, but instead adds _reporting data_ / inventory.
9797
To find this, go back to the **Reports** application:
9898

99-
![](back-to-reports.png)
99+
{{< wideimg "back-to-reports.png" "Screenshot of Mission Portal highlighting the button to go back to the Reports screen." >}}
100100

101101
Then, click on **Inventory** to open up a new inventory report:
102102

103-
![](click-inventory.png)
103+
{{< wideimg "click-inventory.png" "The inventory button highlighted within the reports application." >}}
104104

105105
Click on **Columns** so we can add the new data as a new column:
106106

107-
![](click-columns.png)
107+
{{< wideimg "click-columns.png" "Inventory report with information about each host, with the columns button highlighted." >}}
108108

109109
Use the search bar or scroll to find the new data:
110110

111-
![](etc-column.png)
111+
{{< wideimg "etc-column.png" "Popup for editing columns and search bar for finding modules to add, highlighting a search for etc columns " >}}
112112

113113
After finding the inventory attribute, clicking **Add** and then **Done** we see it as a new column in the report:
114114

115-
![](inventory-with-etc-hosts.png)
115+
{{< wideimg "inventory-with-etc-hosts.png" "New inventory report where the /etc/hosts columns is added." >}}
116116

117117
## What's next
118118

0 commit comments

Comments
 (0)