feat(new): grafana custom package

cmf-cli/Commands/new/GrafanaCommand.cs

@@ -0,0 +1,48 @@
+using System.Collections.Generic;
+using System.IO.Abstractions;
+using Cmf.CLI.Core.Attributes;
+using Cmf.CLI.Core.Enums;
+using Cmf.CLI.Core.Objects;
+using Cmf.CLI.Utilities;
+
+namespace Cmf.CLI.Commands.New
+{
+    /// <summary>
+    /// Generates the Grafana folder structure
+    /// </summary>
+    [CmfCommand(Name = "grafana", Id = "new_grafana", ParentId = "new")]
+    public class GrafanaCommand : LayerTemplateCommand
+    {
+        /// <summary>
+        /// constructor
+        /// </summary>
+        public GrafanaCommand() : base("grafana", PackageType.Grafana)
+        {
+        }
+
+        /// <summary>
+        /// constructor
+        /// </summary>
+        /// <param name="fileSystem"></param>
+        public GrafanaCommand(IFileSystem fileSystem) : base("grafana", PackageType.Grafana, fileSystem)
+        {
+        }
+
+        /// <inheritdoc />
+        protected override List<string> GenerateArgs(IDirectoryInfo projectRoot, IDirectoryInfo workingDir, List<string> args)
+        {
+            if (ExecutionContext.Instance.ProjectConfig.MESVersion.Major < 10)
+            {
+                throw new CliException("Version unsupported, available in MES >= 10");
+            }
+
+            var isRepositoryType = ExecutionContext.Instance.ProjectConfig.RepositoryType == RepositoryType.App;
+
+            args.AddRange(new[]
+            {
+                "--app", isRepositoryType.ToString(),
+            });
+            return args;
+        }
+    }
+}

cmf-cli/Factories/PackageTypeFactory.cs

@@ -65,6 +65,7 @@ public static IPackageTypeHandler GetPackageTypeHandler(CmfPackage cmfPackage, b
                 PackageType.Database => new DatabasePackageTypeHandler(cmfPackage),
                 PackageType.Tests => new TestPackageTypeHandler(cmfPackage),
                 PackageType.SecurityPortal => SecurityPortalHandler(cmfPackage),
+                PackageType.Grafana => new GrafanaPackageTypeHandler(cmfPackage),
                 _ => throw new CliException(string.Format(CoreMessages.PackageTypeHandlerNotImplemented, cmfPackage.PackageType.ToString()))
             };
 

cmf-cli/Handlers/PackageType/GrafanaPackageTypeHandler.cs

@@ -0,0 +1,60 @@
+using System.Collections.Generic;
+using System.IO.Abstractions;
+using System.Linq;
+using Cmf.CLI.Builders;
+using Cmf.CLI.Core.Enums;
+using Cmf.CLI.Core.Objects;
+
+namespace Cmf.CLI.Handlers
+{
+    /// <summary>
+    /// Grafana package type handler.
+    /// </summary>
+    /// <seealso cref="PackageTypeHandler" />
+    public class GrafanaPackageTypeHandler : PackageTypeHandler
+    {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="GrafanaPackageTypeHandler" /> class.
+        /// </summary>
+        /// <param name="cmfPackage">The CMF package.</param>
+        public GrafanaPackageTypeHandler(CmfPackage cmfPackage) : base(cmfPackage)
+        {
+            cmfPackage.SetDefaultValues
+            (
+                targetLayer: "Grafana",
+                isInstallable: true,
+                isUniqueInstall: true,
+                steps: new List<Step>()
+                {
+                    new(StepType.DeployFiles)
+                    {
+                        ContentPath = "**/**"
+                    },
+                }
+            );
+
+            IEnumerable<IBuildCommand> buildSteps = cmfPackage.BuildSteps?.Select(pbs => new SingleStepCommand() { BuildStep = pbs } as IBuildCommand);
+
+            if (buildSteps != null && buildSteps.Any()) {
+                BuildSteps = buildSteps.ToArray();
+            }
+        }
+
+        /// <summary>
+        /// Pack a Data package
+        /// </summary>
+        /// <param name="packageOutputDir">source directory</param>
+        /// <param name="outputDir">output directory</param>
+        public override void Pack(IDirectoryInfo packageOutputDir, IDirectoryInfo outputDir)
+        {
+            const string readmeFilename = "README.md";
+
+            if (outputDir.FileSystem.File.Exists(readmeFilename))
+            {
+                outputDir.FileSystem.File.Delete(readmeFilename);
+            }
+
+            base.Pack(packageOutputDir, outputDir);
+        }
+    }
+}

cmf-cli/resources/template_feed/feature/.template.config/template.json

@@ -24,7 +24,7 @@
       "datatype": "string",
       "description": "The custom package name",
       "displayName": "Package Name",
-      "replaces": "<%= $CLI_PARAM_CustomPackageName %>",
+      "replaces": "<%= $CLI_PARAM_CustomPackageName %>"
       //"fileRename": "Feature.Package"
     },
     "packageVersion": {

cmf-cli/resources/template_feed/grafana/.template.config/template.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "http://json.schemastore.org/template",
+  "author": "Critical Manufacturing",
+  "classifications": [
+    "cli"
+  ],
+  "description": "Generate a new Grafana package",
+  "name": "Grafana Package",
+  "identity": "cmf-cli.new.grafana",
+  "groupIdentity": "cmf-cli.new.grafana",
+  "shortName": "grafana",
+  "tags": {
+    "language": "C#",
+    // Specify that this template is in C#.
+    "type": "project"
+  },
+  "sourceName": "Grafana.Package",
+  "preferNameDirectory": true,
+  "symbols": {
+    "name": {
+      "type": "parameter",
+      "datatype": "string",
+      "description": "The custom package name",
+      "displayName": "Package Name",
+      "replaces": "<%= $CLI_PARAM_CustomPackageName %>"
+    },
+    "packageVersion": {
+      "type": "parameter",
+      "datatype": "string",
+      "description": "The custom package version",
+      "displayName": "Package Version",
+      "replaces": "<%= $CLI_PARAM_CustomPackageVersion %>",
+      "fileRename": "%version%"
+    },
+    "Tenant": {
+      "type": "parameter",
+      "datatype": "string",
+      "replaces": "<%= $CLI_PARAM_Tenant %>",
+      "fileRename": "%Tenant%"
+    },
+    "app": {
+      "type": "parameter",
+      "datatype": "bool",
+      "defaultValue": "False",
+      "description": "Indicates that repository type is app if true"
+    }
+  }
+}

cmf-cli/resources/template_feed/grafana/Grafana.Package/%version%/dashboards/dashboards.yaml

@@ -0,0 +1,9 @@
+apiVersion: 1
+
+providers:
+  - name: Default   
+    folder: <%= $CLI_PARAM_Tenant %>
+    type: file
+    options:
+      path:  /etc/grafana/provisioning/dashboards
+      foldersFromFilesStructure: true

cmf-cli/resources/template_feed/grafana/Grafana.Package/%version%/datasources/datasources.yaml

@@ -0,0 +1,11 @@
+apiVersion: 1
+
+datasources:
+#if (app)
+  - name: CMF gRPC Datasource
+    type: criticalmanufacturing-grpc-datasource
+    jsonData:
+      endpoint: #container-name:port#
+#else
+  ~
+#endif

cmf-cli/resources/template_feed/grafana/Grafana.Package/README.md

@@ -0,0 +1,31 @@
+# Grafana custom Package Datasources
+
+If you want to know more about data sources in general [Official Documentation here!](https://grafana.com/docs/grafana/latest/datasources/)
+
+This information is for local development only!
+
+In order to create custom data sources or dashboards you should put them in the respective folders.
+
+If you are building an app and want to use the gRPC Data Manager data source you can import the following configuration into your local grafana instance:
+
+``` json
+{
+  "id": 1,
+  "uid": "KHanA1bVk",
+  "orgId": 1,
+  "name": "CMF gRPC Datasource",
+  "type": "criticalmanufacturing-grpc-datasource",
+  "typeName": "CMF gRPC Datasource",
+  "typeLogoUrl": "public/plugins/criticalmanufacturing-grpc-datasource/img/logo.svg",
+  "access": "proxy",
+  "url": "",
+  "user": "",
+  "database": "",
+  "basicAuth": false,
+  "isDefault": false,
+  "jsonData": {
+    "endpoint": "datamanager.resourcemonitordevos1.apps.vmrhosdsclt1.cmf.criticalmanufacturing.com:80"
+  },
+  "readOnly": false
+}
+```

cmf-cli/resources/template_feed/grafana/Grafana.Package/cmfpackage.json

@@ -0,0 +1,15 @@
+{
+  "packageId": "<%= $CLI_PARAM_CustomPackageName %>",
+  "version": "<%= $CLI_PARAM_CustomPackageVersion %>",
+  "description": "Cmf Custom <%= $CLI_PARAM_Tenant %> <%= $CLI_PARAM_CustomPackageName %> Package",
+  "packageType": "Grafana",
+  "contentToPack": [
+    {
+      "source": "$(version)/*",
+      "target": "",
+      "ignoreFiles": [
+        "../.cmfpackageignore"
+      ]
+    }
+  ]
+}

core/Enums/PackageType.cs

@@ -84,5 +84,10 @@ public enum PackageType
         /// The specific product database
         /// </summary>
         ProductDatabase = 15,
+
+        /// <summary>
+        /// The Grafana
+        /// </summary>
+        Grafana = 16,
     }
 }

tests/Objects/MockPackage.cs

@@ -9,6 +9,59 @@ namespace tests.Objects
 {
     internal static class MockPackage
     {
+        internal static readonly MockFileSystem Grafana = new MockFileSystem(new Dictionary<string, MockFileData>
+        {
+            { MockUnixSupport.Path(@"c:\.project-config.json"), new MockFileData(
+                @"{
+                    ""ProjectName"": ""MockGrafana"",
+                    ""Tenant"": ""MockTenant"",
+                    ""MESVersion"": ""10.2.1"",
+                    ""NGXSchematicsVersion"": ""1.3.3"",
+                    ""RepositoryType"": ""App"",
+                }")
+            },
+            { MockUnixSupport.Path(@"c:\grafana\1.1.0\dashboards\dashboards.yaml"), new MockFileData(
+                @"{
+                apiVersion: 1
+                providers:
+                  - name: Default   
+                    folder: CoolApp
+                    type: file
+                    options:
+                      path:  /etc/grafana/provisioning/dashboards
+                      foldersFromFilesStructure: true
+                }")},
+            { MockUnixSupport.Path(@"c:\grafana\1.1.0\datasources\datasources.yaml"), new MockFileData(
+                @"{
+                apiVersion: 1
+                datasources:
+                  ~
+                }")},
+            { MockUnixSupport.Path(@"c:\grafana\cmfpackage.json"), new MockFileData(
+            $@"{{
+                ""packageId"": ""Cmf.Custom.Grafana"",
+                ""version"": ""1.1.0"",
+                ""description"": ""Cmf Custom Grafana Package"",
+                ""packageType"": ""Generic"",
+                ""targetLayer"": ""grafana"",
+                ""isInstallable"": true,
+                ""isUniqueInstall"": true,
+	            ""steps"": [
+		            {{
+			            ""order"": ""1"",
+			            ""type"": ""DeployFiles"",
+			            ""ContentPath"": ""**/**""
+		            }}
+	            ],
+                ""buildsteps"": [],
+                ""contentToPack"": [
+                {{
+                    ""source"": ""{MockUnixSupport.Path("1.1.0\\*").Replace("\\", "\\\\")}"",
+                    ""target"": """"
+                }}
+              ]
+            }}")}});
+
         internal static readonly MockFileSystem Html = new MockFileSystem(new Dictionary<string, MockFileData>
         {
             { MockUnixSupport.Path(@"c:\.project-config.json"), new MockFileData(

tests/Specs/New.cs

@@ -94,6 +94,40 @@ public void Business(BaseLayer layer, RepositoryType repositoryType = Repository
                 });
         }
 
+        [Theory]
+        [InlineData(BaseLayer.Core, RepositoryType.App)]
+        [InlineData(BaseLayer.MES, RepositoryType.Customization)]
+        public void Grafana(BaseLayer baseLayer, RepositoryType repositoryType)
+        {
+            RunNew(
+                new GrafanaCommand(), 
+                "Cmf.Custom.Grafana",
+                mesVersion: "10.2.1", 
+                ngxSchematicsVersion: "1.3.3",
+                baseLayer: baseLayer, 
+                repositoryType: repositoryType, 
+                extraAsserts: args =>
+            {
+                var (pkgVersion, dir) = args;
+
+                var tenant = ExecutionContext.Instance.ProjectConfig.Tenant;
+
+                Assert.True(Directory.Exists("Cmf.Custom.Grafana"), "Grafana package folder is missing");
+                Assert.True(File.Exists($"Cmf.Custom.Grafana/README.md"), "README file is missing or has wrong name");
+
+                Assert.True(Directory.Exists($"Cmf.Custom.Grafana/{pkgVersion}"), "Grafana Version folder is missing");
+                Assert.True(Directory.Exists($"Cmf.Custom.Grafana/{pkgVersion}/dashboards"), "Grafana dashboards folder is missing");
+                Assert.True(Directory.Exists($"Cmf.Custom.Grafana/{pkgVersion}/datasources"), "Grafana datasources folder is missing");
+
+                Assert.True(Directory.Exists($"Cmf.Custom.Grafana/{pkgVersion}/dashboards/{tenant}/"), $"{tenant} Dashboards folder is missing or has wrong name");
+                Assert.True(File.Exists($"Cmf.Custom.Grafana/{pkgVersion}/dashboards/dashboards.yaml"), "Dashboards configuration file is missing or has wrong name");
+
+                Assert.True(File.Exists(
+                    $"Cmf.Custom.Grafana/{pkgVersion}/datasources/datasources.yaml"), 
+                    "Datasources configuration file is missing or has wrong name");
+            });
+        }
+
         [Fact]
         public void Data()
         {