From dff1b54aa68445a4f911ceb0e571d343e277c435 Mon Sep 17 00:00:00 2001 From: Samuel Date: Tue, 8 Feb 2022 12:11:21 +0100 Subject: [PATCH] feat(oac): improved descriptions and summary --- .../observability-as-code/ansible/config.yml | 17 +++++++++++++---- .../observability-as-code/chef/config.yml | 13 +++++++++++-- .../observability-as-code/pulumi/config.yml | 11 +++++++++-- .../observability-as-code/puppet/config.yml | 13 +++++++++---- .../observability-as-code/terraform/config.yml | 10 ++++++++-- 5 files changed, 50 insertions(+), 14 deletions(-) diff --git a/quickstarts/observability-as-code/ansible/config.yml b/quickstarts/observability-as-code/ansible/config.yml index c3fbe24415..2283a1e026 100644 --- a/quickstarts/observability-as-code/ansible/config.yml +++ b/quickstarts/observability-as-code/ansible/config.yml @@ -8,13 +8,22 @@ title: Ansible # Long-form description of the quickstart (required) description: | - Open-source software provisioning, configuration management, and - application-deployment tool enabling infrastructure as code. + # What is Ansible? + Ansible is a radically simple IT automation engine that automates cloud provisioning, configuration management, application deployment, intra-service orchestration, and many other IT needs. + + Designed for multi-tier deployments since day one, Ansible models your IT infrastructure by describing how all of your systems inter-relate, rather than just managing one system at a time. + + It uses no agents and no additional custom security infrastructure, so it's easy to deploy - and most importantly, it uses a very simple language (YAML, in the form of Ansible Playbooks) that allow you to describe your automation jobs in a way that approaches plain English. + + # What does New Relic provide + New Relic has developed a Ansible playbook for the Ansible agent to deploy the [New Relic Infrastructure agent](https://docs.newrelic.com/docs/infrastructure/infrastructure-monitoring/get-started/get-started-infrastructure-monitoring/) and [On Host Integrations](https://docs.newrelic.com/docs/infrastructure/host-integrations/get-started/introduction-host-integrations) throughout your environment. + + # How to get started? + Follow the instructions on New Relic documentation: [Configure the infrastructure agent using Ansible](https://docs.newrelic.com/docs/infrastructure/new-relic-infrastructure/config-management-tools/configure-new-relic-infrastructure-using-ansible) # Displayed in search results and recommendations. Summarizes a quickstarts functionality. summary: | - Open-source software provisioning, configuration management, and - application-deployment tool enabling infrastructure as code. + New Relic Ansible playbook to deploy the New Relic Infrastructure agent and On Host Integrations throughout your environment. # Support level: New Relic | Verified | Community (required) level: New Relic diff --git a/quickstarts/observability-as-code/chef/config.yml b/quickstarts/observability-as-code/chef/config.yml index a917d02633..c5b6ebb445 100644 --- a/quickstarts/observability-as-code/chef/config.yml +++ b/quickstarts/observability-as-code/chef/config.yml @@ -8,11 +8,20 @@ title: Chef # Long-form description of the quickstart (required) description: | - Chef is a configuration management tool written in Ruby and Erlang. + # What is Chef? + Chef Infrastructure Management enables DevOps teams to model and deploy secure and scalable infrastructure automation across any cloud, VM, and/or physical infrastructure. + + The Chef Infra agent is self-updating, self-automating and works well in low bandwidth or remote environments. It also allows Chef to scale up and down as customers demands change. Security keys are managed and rotated regularly using Chef automated cookbooks which allows admins to turn off port access to SSH and WinRM further securing their environments in line with recommendations from industry standards like CIS (Center for Internet Security) benchmarks. + + # What does New Relic provide + New Relic has developed a Chef recipe for the Chef Infra agent to deploy the [New Relic Infrastructure agent](https://docs.newrelic.com/docs/infrastructure/infrastructure-monitoring/get-started/get-started-infrastructure-monitoring/) and [On Host Integrations](https://docs.newrelic.com/docs/infrastructure/host-integrations/get-started/introduction-host-integrations) throughout your environment. + + # How to get started? + Follow the instructions on New Relic documentation: [Configure the infrastructure agent using Chef](https://docs.newrelic.com/docs/infrastructure/new-relic-infrastructure/config-management-tools/configure-new-relic-infrastructure-using-chef) # Displayed in search results and recommendations. Summarizes a quickstarts functionality. summary: | - Chef is a configuration management tool written in Ruby and Erlang. + New Relic Chef recipe to deploy the New Relic Infrastructure agent and On Host Integrations throughout your environment. # Support level: New Relic | Verified | Community (required) level: New Relic diff --git a/quickstarts/observability-as-code/pulumi/config.yml b/quickstarts/observability-as-code/pulumi/config.yml index 1abb2c7e01..d1b2183aaa 100644 --- a/quickstarts/observability-as-code/pulumi/config.yml +++ b/quickstarts/observability-as-code/pulumi/config.yml @@ -6,8 +6,15 @@ title: Pulumi # Long-form description of the quickstart (required) description: | - Pulumi is a popular infrastructure-as-code software tool. - You use it to provision all kinds of infrastructure and services, including New Relic entities, dashboard, alerts and synthetics. + # What is Pulumi? + Pulumi is a popular infrastructure-as-code software tool. Pulumi enables teams to use a unified software engineering process to deliver infrastructure and applications together and faster. This increases agility, reduces risks, and speeds innovation. You use it to provision all kinds of infrastructure and services, including New Relic entities, dashboard, alerts and synthetics. + + # What does New Relic provide + Pulumi has developed a New Relic Package to configure alerts, synthetics, dashboards, and other parts of New Relic through declarative configuration files. + + # How to get started? + Follow the instructions on Pulumi package documentation: [Getting Started with the New Relic Package](https://www.pulumi.com/registry/packages/newrelic/) + # Displayed in search results and recommendations. Summarizes a quickstarts functionality. summary: | diff --git a/quickstarts/observability-as-code/puppet/config.yml b/quickstarts/observability-as-code/puppet/config.yml index a85adca9d9..a49245fbac 100644 --- a/quickstarts/observability-as-code/puppet/config.yml +++ b/quickstarts/observability-as-code/puppet/config.yml @@ -8,13 +8,18 @@ title: Puppet # Long-form description of the quickstart (required) description: | - Puppet is a configuration management tool used to manage various stages of the - IT infrastructure lifecycle. + # What is Puppet? + Puppet is the industry standard for IT automation. Modernize, manage and bring your hybrid infrastructure into compliance through Puppet's powerful continuous automation. + + # What does New Relic provide + New Relic has developed a Puppet module for the Puppet agent to deploy the [New Relic Infrastructure agent](https://docs.newrelic.com/docs/infrastructure/infrastructure-monitoring/get-started/get-started-infrastructure-monitoring/) and [On Host Integrations](https://docs.newrelic.com/docs/infrastructure/host-integrations/get-started/introduction-host-integrations) throughout your environment. + + # How to get started? + Follow the instructions on New Relic documentation: [Configure the infrastructure agent using Puppet](https://docs.newrelic.com/docs/infrastructure/new-relic-infrastructure/config-management-tools/configure-new-relic-infrastructure-puppet) # Displayed in search results and recommendations. Summarizes a quickstarts functionality. summary: | - Puppet is a configuration management tool used to manage various stages of the - IT infrastructure lifecycle. + New Relic Puppet module to deploy the New Relic Infrastructure agent and On Host Integrations throughout your environment. # Support level: New Relic | Verified | Community (required) level: New Relic diff --git a/quickstarts/observability-as-code/terraform/config.yml b/quickstarts/observability-as-code/terraform/config.yml index 9fdb4ccaf2..7c27d184cf 100644 --- a/quickstarts/observability-as-code/terraform/config.yml +++ b/quickstarts/observability-as-code/terraform/config.yml @@ -6,8 +6,14 @@ title: Terraform # Long-form description of the quickstart (required) description: | - Terraform is a popular infrastructure-as-code software tool built by HashiCorp. - You use it to provision all kinds of infrastructure and services, including New Relic entities, dashboard, alerts and synthetics. + # What is Terraform? + Terraform is an open-source infrastructure as code software tool that provides a consistent CLI workflow to manage hundreds of cloud services. Terraform codifies cloud APIs into declarative configuration files. + + # What does New Relic provide + New Relic has developed a Terraform provider to configure alerts, synthetics, dashboards, and other parts of New Relic through declarative configuration files. + + # How to get started? + Follow the instructions on Terraform provider documentation: [Getting Started with the New Relic Provider](https://registry.terraform.io/providers/newrelic/newrelic/latest/docs/guides/getting_started) # Displayed in search results and recommendations. Summarizes a quickstarts functionality. summary: |