package pullrequest import ( "context" "fmt" "net/url" "path" "strings" "github.com/grafana/grafana-app-sdk/logging" dashboard "github.com/grafana/grafana/apps/dashboard/pkg/apis/dashboard/v1beta1" provisioning "github.com/grafana/grafana/apps/provisioning/pkg/apis/provisioning/v0alpha1" "github.com/grafana/grafana/apps/provisioning/pkg/repository" "github.com/grafana/grafana/pkg/cmd/grafana-cli/logger" "github.com/grafana/grafana/pkg/infra/slugify" "github.com/grafana/grafana/pkg/registry/apis/provisioning/jobs" "github.com/grafana/grafana/pkg/registry/apis/provisioning/resources" ) type changeInfo struct { GrafanaBaseURL string // Files we tried to read Changes []fileChangeInfo // More files changed than we processed SkippedFiles int // Requested image render, but it is not available MissingImageRenderer bool } type fileChangeInfo struct { Change repository.VersionedFileChange Error string // The parsed value Parsed *resources.ParsedResource // The title from inside the resource (or name if not found) Title string // The URL where this will appear (target) GrafanaURL string GrafanaScreenshotURL string // URL where we can see a preview of this particular change PreviewURL string PreviewScreenshotURL string } type evaluator struct { render ScreenshotRenderer parsers resources.ParserFactory urlProvider func(namespace string) string } func NewEvaluator(render ScreenshotRenderer, parsers resources.ParserFactory, urlProvider func(namespace string) string) Evaluator { return &evaluator{ render: render, parsers: parsers, urlProvider: urlProvider, } } // This will process the list of versioned file changes into changeInfo func (e *evaluator) Evaluate(ctx context.Context, repo repository.Reader, opts provisioning.PullRequestJobOptions, changes []repository.VersionedFileChange, progress jobs.JobProgressRecorder) (changeInfo, error) { cfg := repo.Config() parser, err := e.parsers.GetParser(ctx, repo) if err != nil { return changeInfo{}, fmt.Errorf("failed to get parser for %s: %w", cfg.Name, err) } rendererAvailable := e.render.IsAvailable(ctx) shouldRender := rendererAvailable && len(changes) == 1 && cfg.Spec.GitHub.GenerateDashboardPreviews info := changeInfo{ GrafanaBaseURL: e.urlProvider(cfg.Namespace), MissingImageRenderer: !rendererAvailable, } logger := logging.FromContext(ctx) for i, change := range changes { // process maximum 10 files if i >= 10 { info.SkippedFiles = len(changes) - i logger.Info("skipping remaining files", "count", info.SkippedFiles) break } progress.SetMessage(ctx, fmt.Sprintf("process %s", change.Path)) logger.With("action", change.Action).With("path", change.Path) info.Changes = append(info.Changes, e.evaluateFile(ctx, repo, info.GrafanaBaseURL, change, opts, parser, shouldRender)) } return info, nil } var dashboardKind = dashboard.DashboardResourceInfo.GroupVersionKind().Kind func (e *evaluator) evaluateFile(ctx context.Context, repo repository.Reader, baseURL string, change repository.VersionedFileChange, opts provisioning.PullRequestJobOptions, parser resources.Parser, shouldRender bool) fileChangeInfo { if change.Action == repository.FileActionDeleted { // TODO: read the old and verify return fileChangeInfo{Change: change, Error: "delete feedback not yet implemented"} } info := fileChangeInfo{Change: change} fileInfo, err := repo.Read(ctx, change.Path, change.Ref) if err != nil { logger.Info("unable to read file", "err", err) info.Error = err.Error() return info } // Read the file as a resource info.Parsed, err = parser.Parse(ctx, fileInfo) if err != nil { info.Error = err.Error() return info } // Find a name within the file obj := info.Parsed.Obj info.Title = info.Parsed.Meta.FindTitle(obj.GetName()) // Check what happens when we apply changes // NOTE: this will also invoke any server side validation err = info.Parsed.DryRun(ctx) if err != nil { info.Error = err.Error() return info } // Dashboards get special handling if info.Parsed.GVK.Kind == dashboardKind { // FIXME: extract the logic out of a dashboard URL builder/injector or similar // for testability and decoupling if info.Parsed.Existing != nil { info.GrafanaURL = fmt.Sprintf("%sd/%s/%s", baseURL, obj.GetName(), slugify.Slugify(info.Title)) } // Load this file directly info.PreviewURL = baseURL + path.Join("admin/provisioning", info.Parsed.Repo.Name, "dashboard/preview", info.Parsed.Info.Path) query := url.Values{} query.Set("ref", info.Parsed.Info.Ref) if opts.URL != "" { query.Set("pull_request_url", url.QueryEscape(opts.URL)) } info.PreviewURL += "?" + query.Encode() if shouldRender { if info.GrafanaURL != "" { info.GrafanaScreenshotURL, err = renderScreenshotFromGrafanaURL(ctx, baseURL, e.render, info.Parsed.Repo, info.GrafanaURL) if err != nil { info.Error = err.Error() } } if info.PreviewURL != "" { info.PreviewScreenshotURL, err = renderScreenshotFromGrafanaURL(ctx, baseURL, e.render, info.Parsed.Repo, info.PreviewURL) if err != nil { info.Error = err.Error() } } } } return info } func renderScreenshotFromGrafanaURL(ctx context.Context, baseURL string, renderer ScreenshotRenderer, repo provisioning.ResourceRepositoryInfo, grafanaURL string, ) (string, error) { parsed, err := url.Parse(grafanaURL) if err != nil { logging.FromContext(ctx).Warn("invalid", "url", grafanaURL, "err", err) return "", err } snap, err := renderer.RenderScreenshot(ctx, repo, strings.TrimPrefix(parsed.Path, "/"), parsed.Query()) if err != nil { logging.FromContext(ctx).Warn("render failed", "url", grafanaURL, "err", err) return "", fmt.Errorf("error rendering screenshot: %w", err) } if strings.Contains(snap, "://") { return snap, nil // it is a full URL already (can happen when the blob storage returns CDN urls) } base, err := url.Parse(baseURL) if err != nil { logger.Warn("invalid base", "url", baseURL, "err", err) return "", err } return base.JoinPath(snap).String(), nil }