From 917ba30fbac58a0caa0aabaaa433552f05c015c2 Mon Sep 17 00:00:00 2001 From: blam Date: Mon, 26 Jul 2021 20:26:45 +0200 Subject: [PATCH] chore: fixing prettier linting for blog post Signed-off-by: blam --- ...21-07-26-software-templates-are-now-in-beta.md | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/microsite/blog/2021-07-26-software-templates-are-now-in-beta.md b/microsite/blog/2021-07-26-software-templates-are-now-in-beta.md index 3c6984295e..bc9b9801b3 100644 --- a/microsite/blog/2021-07-26-software-templates-are-now-in-beta.md +++ b/microsite/blog/2021-07-26-software-templates-are-now-in-beta.md @@ -7,7 +7,7 @@ authorImageURL: https://avatars.githubusercontent.com/u/3645856?v=4 ![Software Templates in Beta](assets/21-07-26/backstage-software-templates-beta.gif) -**TLDR**; At a high level, Backstage performs three main jobs: [Create, Manage, and Explore](https://backstage.io/blog/2021/05/20/adopting-backstage#three-jobs-create-manage-explore). Throughout the year, we’ve been focussed on improving the stability and scalability of these areas while enhancing the feature sets based upon requests from the community. Software Templates — which enable push-button deployments with all your standards and best practices built-in — is our first feature-complete release candidate to graduate to beta. Read on to learn how this release improves template customization and flexibility, as well as performance. +**TLDR**; At a high level, Backstage performs three main jobs: [Create, Manage, and Explore](https://backstage.io/blog/2021/05/20/adopting-backstage#three-jobs-create-manage-explore). Throughout the year, we’ve been focussed on improving the stability and scalability of these areas while enhancing the feature sets based upon requests from the community. Software Templates — which enable push-button deployments with all your standards and best practices built-in — is our first feature-complete release candidate to graduate to beta. Read on to learn how this release improves template customization and flexibility, as well as performance. @@ -28,37 +28,38 @@ Following the removal of the previously deprecated `backstage.io/v1alpha1` templ With it comes an entirely new architecture to the Software Templates functionality, and a load of new exciting features, which I’ll dig into a little deeper. ### Template actions + We’ve totally opened up the ability to compose your own workflows for each Template that you have registered in Software Templates. This means no restrictions on where your template skeleton is kept, and no restrictions on what your workflow should look like. Template Actions are customizable JavaScript functions that allow you to extend the capabilities of the Software Templates by adding your own business logic or reusing some of our Built-In actions. ![New template syntax with actions](assets/21-07-26/example-template-code.png) -*An example of the new template syntax with steps and parameters* +_An example of the new template syntax with steps and parameters_ The workflow for Software Templates are now step-based, and each Software Template can have a customizable amount of steps which will in turn call these new actions. ![New steps being rendered in the frontend](assets/21-07-26/steps-running.gif) -*An example of a Template with customizable steps* +_An example of a Template with customizable steps_ These actions are very heavily inspired by GitHub Actions and GitHub Workflows, and we’ve given back a lot of control to the template authors so they can build the boilerplate and push the code however they want. ### Custom UI extensions + A large part of the Software Templates feature is the form that we use to collect user input which is then passed on to these new actions. Sometimes, it makes sense that Template Authors want to provide their own React components which can be rendered in the frontend to maybe do some more complex things like calling internal APIs to provide autocomplete. This is now possible with the new `ScaffolderFieldExtensions`. ![Custom UI extensions](assets/21-07-26/custom-components.gif) -*An example of `ScaffolderFieldExtension` is the `OwnerPicker` component which can automatically add options and suggest typeahead with data from an async API request* +_An example of `ScaffolderFieldExtension` is the `OwnerPicker` component which can automatically add options and suggest typeahead with data from an async API request_ Template Authors can create their own components to provide data to the custom actions in any way you see fit, and even override our own built in ones too like the `RepoUrlPicker`. ### Horizontal scalability + The Scaffolder Service and Software Templates are now horizontally scalable, coordinating work between your deployed backend machines. This means now that the number of instances of the `@backstage/plugin-scaffolder-backend` plugin you have, is the same amount of jobs that you can have in parallel. This ensures that your tasks are handled quickly and reliably, while providing great feedback in the process. ## Try out the new templates + We’re still on the journey to making the Software Templates a great user experience for both authors and developers — but we’re not done yet, so watch this space for new exciting features to come! In the meantime, make sure to visit the documentation for [building templates](https://backstage.io/docs/features/software-templates/adding-templates) or creating your own [custom actions](https://backstage.io/docs/features/software-templates/writing-custom-actions). - - -