Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions _vendor/github.com/chef/samples/cohorts/skill-assembly.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

1 change: 1 addition & 0 deletions _vendor/github.com/chef/samples/sample.text

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion _vendor/modules.txt
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
# github.com/chef/compliance-profiles/docs-chef-io v0.0.0-20250424114557-297ae97f62c2
# github.com/chef/compliance-remediation-2022/docs-chef-io v0.0.0-20250506081430-c04163aa35a9
# github.com/chef/license-service/docs-chef-io v0.0.0-20250120051510-ae1de80f4621
# github.com/chef/samples v0.0.0-20250304162216-b7bf3710b07e
# github.com/chef/samples v0.0.0-20250424163637-3393187e624c
# github.com/chef/chef-docs-theme v0.0.0-20250217213320-727f9bce8258
# github.com/FortAwesome/Font-Awesome v0.0.0-20240108205627-a1232e345536
# github.com/cowboy/jquery-hashchange v0.0.0-20100902193700-0310f3847f90
Expand Down
32 changes: 16 additions & 16 deletions content/360/saas/get_started/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,29 +9,29 @@ parent = "chef_cloud/360/get_started"
weight = 10
+++

This section provides quickstart guides for getting started with Chef 360 SaaS and its tools.
This section is a quickstart guide to using Chef 360 SaaS and its tools.

## Get started guides
## How Chef 360 SaaS works

Before you begin with these guides, [review the system requirements]({{< relref "system_requirements" >}}).
Chef 360 SaaS consists of three main components:

Chef 360 SaaS guides:
- **Chef 360 SaaS CLIs**: Users use the CLIs to define and invoke Chef Courier jobs, and configure user accounts, tenants, organizations, and nodes.
- **Chef 360 SaaS**: Manages users, organizations, and tenants, schedules and distributes Courier jobs, and monitors nodes and job results.
- **Chef skills**: Chef 360 SaaS installs skills on each node that manage the node, execute jobs, and report to Chef 360 SaaS.

- [Set up Chef 360 SaaS]({{< relref "set_up" >}})
## What this guide covers

Chef 360 Platform CLI guides:
This guide walks you through the following steps:

- [Install and register the Chef 360 Platform CLIs]({{< relref "install_cli" >}})
1. Installing Chef 360 SaaS in a single-node Kubernetes cluster.
1. Installing Chef 360 SaaS CLIs on a local workstation and registering it with Chef 360 SaaS.
1. Enrolling a node with Chef 360 SaaS. Nodes can be enrolled using a Chef 360 SaaS CLI or by uploading a Chef Infra cookbook if Chef Infra Client is already installed on the node.
1. Defining and running a basic job on a node, and reviewing the job's execution details and the results of each step.

Chef Node Management guides:
## Before you begin

- [Register the Node Management agent]({{< relref "register_node_agent" >}})
- [Define skills]({{< relref "define_skills" >}})
- [Create a skill assembly]({{< relref "create_skill_assembly" >}})
- [Create override settings]({{< relref "override_settings" >}})
- [Create a node cohort]({{< relref "node_cohort" >}})
- [Enroll nodes]({{< relref "enroll_nodes" >}})
- Review the [Chef 360 SaaS system requirements]({{< relref "/360/saas/system_requirements.md" >}}).

Chef Courier job guides:
## Next steps

- [Run jobs with Chef Courier]({{< relref "jobs" >}})
- [Set up Chef 360 SaaS]({{< relref "/360/saas/get_started/set_up.md" >}}).
33 changes: 0 additions & 33 deletions content/360/saas/get_started/create_skill_assembly.md

This file was deleted.

131 changes: 0 additions & 131 deletions content/360/saas/get_started/define_skills.md

This file was deleted.

32 changes: 24 additions & 8 deletions content/360/saas/get_started/enroll_nodes.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,31 +8,47 @@ parent = "chef_cloud/360/get_started"
weight = 100
+++

Node enrollment brings nodes under management by Chef 360 SaaS.
When you enroll a node into a node cohort, Chef 360 Platform installs the Chef skills and skill settings that are defined for all nodes in that cohort.
These skills allow Chef 360 Platform to manage the node, execute Chef Courier jobs, and report back to Chef 360 Platform.

Chef 360 Platform installs the following skills in the default skill assembly:

- **Chef Infra Client interpreter skill**: Executes Chef Infra Client runs.
- **Courier Runner skill**: Interprets and executes Chef Courier jobs.
- **Gohai skill**: Reports node attribute data to Chef 360 Platform.
- **Inspec interpreter skill**: Executes Chef InSpec audits.
- **Node Management agent**: Manages and installs other skills on the node.
- **Restart interpreter skill**: Restarts nodes.
- **Shell interpreter skill**: Executes shell scripts.

For more information, see the [Chef 360 skills](https://docs.chef.io/360/1.3/node_management/skills/) documentation.

## Node enrollment methods

This document demonstrates two different methods of node enrollment:

- cookbook-based enrollment
- single-node enrollment

For more information, see the [node enrollment documentation](https://docs.chef.io/360/1.3/node_management/enroll_nodes/).

{{< note >}}

This version of Chef 360 SaaS doesn't support node re-enrollment.
Chef 360 Platform doesn't support node re-enrollment.

{{< /note >}}

## Prerequisites
## Role requirements

- [A node cohort has been created]({{< relref "node_cohort" >}}).
To enroll nodes, use a profile with the [node-manager role](https://docs.chef.io/360/1.3/administration/system_roles/).

## Requirements
## Before you begin

Review the [node requirements]({{< relref "system_requirements#node-requirements" >}}) before enrolling nodes.
- Review the [node requirements]({{< relref "/360/saas/system_requirements#node-requirements" >}}).

## Single-node enrollment

Single-node enrollment enrolls nodes from the server side.
With this method, you define connection and configuration details and push them up to Chef 360 SaaS, which connects to each node and installs Chef Habitat, Chef Node Management, and any skills or agents assigned to a node cohort.
Single-node enrollment allows you to enroll nodes directly from the server side. With this method, you specify the connection and configuration details for each node and upload them to Chef 360 Platform. Chef 360 Platform then connects to each node, installs Chef Habitat, Chef Node Management, and any skills or agents associated with the node's cohort.

### Enroll Linux nodes

Expand Down
13 changes: 7 additions & 6 deletions content/360/saas/get_started/install_cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,11 +10,11 @@ parent = "chef_cloud/360/get_started"
weight = 40
+++

This page documents how to download and install the Chef 360 Platform CLIs and register your workstation with your Chef 360 SaaS deployment.
This page documents how to download and install the Chef 360 SaaS CLIs and register your workstation with your Chef 360 SaaS deployment.

## Prerequisites

- [Chef 360 SaaS configured]({{< relref "set_up" >}}).
- [Chef 360 SaaS is configured]({{< relref "set_up" >}}).
- `/usr/local/bin` is present in the PATH environment variable.

## Install CLIs
Expand Down Expand Up @@ -142,7 +142,7 @@ To create a profile, follow these steps:
1. Optional: Set your new profile as the default profile.
The Chef 360 Platform CLIs use a default profile automatically in any command that accepts the `--profile` argument.
The Chef 360 SaaS CLIs use a default profile automatically in any command that accepts the `--profile` argument.
If you don't set a default profile, you will have to specify it in each command with `--profile <PROFILE_NAME>`.

Set a default profile:
Expand All @@ -155,10 +155,11 @@ To create a profile, follow these steps:

1. Repeat this procedure so that you have separate profiles for the Node Manager and Courier Operator roles.

## Additional information
## More information

- [Chef 360 CLI reference documentation](https://docs.chef.io/360/1.3/reference/cli/)
- [Chef 360 Platform CLI reference documentation](https://docs.chef.io/360/1.3/reference/cli).
- [Chef 360 Platform roles documentation](https://docs.chef.io/360/1.3/administration/system_roles/)

## Next step

- [Register the Node Management agent]({{< relref "register_node_agent.md" >}}).
- [Review the node management settings]({{< relref "node_management_settings" >}})
Loading