Skip to content
Open
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
13 changes: 11 additions & 2 deletions content/chef_install_script.md
Original file line number Diff line number Diff line change
Expand Up @@ -165,8 +165,7 @@ In addition to the default install behavior, the Chef Software install script su
`-P` (`-project` on Windows)

: The product name to install. Supported versions of Chef products are
`chef`,`chef-backend`,`chef-server`,`inspec`,`chef-workstation`,`manage` and
`supermarket`. Default value: `chef`.
`chef`,`chef-backend`,`chef-server`,`inspec`,`chef-workstation`,`manage`,`supermarket` and `chef-ice` . Default value: `chef`.

`-s` (`-install_strategy` on Windows)

Expand All @@ -190,6 +189,16 @@ In addition to the default install behavior, the Chef Software install script su
two-part version (x.y) is also allowed. For more information about
application versioning, see [semver.org](https://semver.org/).

`-i` (`-package_manager` on Windows)

: Specifies the package manager to use for downloading and installing the Chef Infra Client Enterprise. If not provided, the script will auto detect the package manager based on the platform.

Supported values include:

- `deb`: For Debian-based systems (for example: Ubuntu).
- `rpm`: For Red Hat-based systems (for example: CentOS, Fedora).
- `msi`: For Windows systems.

## Release channels

{{< readfile file="content/reusable/md/release_channels.md" >}}
Expand Down
101 changes: 88 additions & 13 deletions content/download/commercial.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,8 @@ The Chef Commercial Download API has the following endpoints:
- `/versions/latest`
- `/metadata`
- `/download`
- `/fileName`
- `/package-managers`

For details about query strings, see the [parameters section](#parameters).

Expand Down Expand Up @@ -109,6 +111,12 @@ The `metadata` endpoint returns data about a particular package of a Chef produc
https://chefdownload-commercial.chef.io/<CHANNEL>/<PRODUCT>/metadata?p=<PLATFORM>&pv=<PLATFORM_VERSION>&m=<ARCHITECTURE>&v=<PRODUCT_VERSION>&license_id=<LICENSE_ID>
```

For products such as Chef Infra Client Enterprise or Chef Infra Client Legacy Migration, the pm (package manager) query parameter must be explicitly provided in the request. This value determines the type of package to retrieve (for example: deb, rpm, msi, or tar) and is required because these products support multiple packaging formats.

```plain
https://chefdownload-commercial.chef.io/<CHANNEL>/<PRODUCT>/metadata?p=<PLATFORM>&pm=<PACKAGE_MANAGER>&m=<ARCHITECTURE>&v=<PRODUCT_VERSION>&license_id=<LICENSE_ID>
```

### download

The `download` endpoint downloads a particular package of a Chef product.
Expand All @@ -117,6 +125,34 @@ The `download` endpoint downloads a particular package of a Chef product.
https://chefdownload-commercial.chef.io/<CHANNEL>/<PRODUCT>/download?p=<PLATFORM>&pv=<PLATFORM_VERSION>&m=<ARCHITECTURE>&v=<PRODUCT_VERSION>&license_id=<LICENSE_ID>
```

For products such as Chef Infra Client Enterprise or Chef Infra Client Legacy Migration, the pm (package manager) query parameter must be explicitly provided in the request. This value determines the type of package to retrieve (for example: deb, rpm, msi, or tar) and is required because these products support multiple packaging formats.

```plain
https://chefdownload-commercial.chef.io/<CHANNEL>/<PRODUCT>/download?p=<PLATFORM>&pm=<PACKAGE_MANAGER>&m=<ARCHITECTURE>&v=<PRODUCT_VERSION>&license_id=<LICENSE_ID>
```

### fileName

The `fileName` endpoint returns the file name.

```plain
https://chefdownload-commercial.chef.io/<CHANNEL>/<PRODUCT>/fileName?p=<PLATFORM>&pv=<PLATFORM_VERSION>&m=<ARCHITECTURE>&v=<PRODUCT_VERSION>&license_id=<LICENSE_ID>
```

For products such as Chef Infra Client Enterprise or Chef Infra Client Legacy Migration, the pm (package manager) query parameter must be explicitly provided in the request. This value determines the type of package to retrieve (for example: deb, rpm, msi, or tar) and is required because these products support multiple packaging formats.

```plain
https://chefdownload-commercial.chef.io/<CHANNEL>/<PRODUCT>/fileName?p=<PLATFORM>&pm=<PACKAGE_MANAGER>&m=<ARCHITECTURE>&v=<PRODUCT_VERSION>&license_id=<LICENSE_ID>
```

### package-managers

The `package-managers` endpoint lists the available package managers.

```plain
https://chefdownload-commercial.chef.io/package-managers
```

## Parameters

The API accepts the following parameters in a query string.
Expand Down Expand Up @@ -166,22 +202,34 @@ The API accepts the following parameters in a query string.

Default value: `latest`.

`pm`
: The package manager.

This parameter is only used for the Chef Infra Client Enterprise and Chef Infra Client Legacy Migration products. For example:

- `deb` for Debian-based systems (for example: Ubuntu)
- `rpm` for Red Hat-based systems (for example: CentOS, Fedora)
- `tar` for generic Unix-like systems
- `msi` for Windows systems

## Chef product names

Use the following product keys to download packages or retrieve data for different Chef products.
You can also use the [products endpoint](#products)

| Product | Product key |
|--------------------|------------------|
| Chef Automate | automate |
| Chef Infra Client | chef |
| Chef Backend | chef-backend |
| Chef Infra Server | chef-server |
| Chef Workstation | chef-workstation |
| Chef Habitat | habitat |
| Chef InSpec | inspec |
| Management Console | manage |
| Supermarket | supermarket |
| Product | Product key |
| ---------------------------------- | ------------------ |
| Chef Automate | `automate` |
| Chef Infra Client | `chef` |
| Chef Backend | `chef-backend` |
| Chef Infra Server | `chef-server` |
| Chef Workstation | `chef-workstation` |
| Chef Habitat | `habitat` |
| Chef InSpec | `inspec` |
| Management Console | `manage` |
| Supermarket | `supermarket` |
| Chef Infra Client Enterprise | `chef-ice` |
| Chef Infra Client Legacy Migration | `migrate-ice` |

See the [supported versions]({{< relref "versions" >}}) documentation for information about the support status of individual products.

Expand All @@ -208,16 +256,43 @@ url "https://chefdownload-commercial.chef.io/stable/chef/download?license_id=<LI
version "18.2.7"
```

To get the latest supported build of Chef Infra Client Enterprise for Linux 18.04, enter the following:

```sh
https://chefdownload-commercial.chef.io/stable/chef-ice/metadata?pv=18.04&m=x86_64&p=linux&pm=deb&license_id=<LICENSE_ID>
```

which returns something like:

```json
sha1 "dcf75b37bb80128af4657501bfd41eac52820191"
sha256 "2c501d02b16d67e9d5a28578b95f8d3155bed940ee4946229213f41a2e8b798e"
url "https://chefdownload-commercial.chef.io/stable/chef-ice/download?license_id=<LICENSE_ID>&eol=false&m=x86_64&p=linux&pm=deb&v=19.1.8"
version "19.1.8"
```

### Download directly

To use cURL to download a package directly, enter the following:
To use curl to download a package directly of Chef Products, enter the following:

```bash
curl -LOJ 'https://chefdownload-commercial.chef.io/<CHANNEL>/<PRODUCT>/download?p=<PLATFORM>&pv=<PLATFORM_VERSION>&m=<ARCHITECTURE>&license_id=<LICENSE_ID>'
```

To use GNU Wget to download a package directly, enter the following:
To use curl to download a package directly of Chef Infra Client Enterprise or Chef Infra Client Legacy Migration, enter the following:

```bash
curl -LOJ 'https://chefdownload-commercial.chef.io/<CHANNEL>/<PRODUCT>/download?p=<PLATFORM>&pm=<PACKAGE_MANAGER>&m=<ARCHITECTURE>&license_id=<LICENSE_ID>'
```

To use GNU Wget to download a package directly of Chef Products, enter the following:

```bash
wget --content-disposition https://chefdownload-commercial.chef.io/<CHANNEL>/<PRODUCT>/download?p=<PLATFORM>&pv=<PLATFORM_VERSION>&m=<ARCHITECTURE>&license_id=<LICENSE_ID>
```

To use GNU Wget to download a package directly of Chef Infra Client Enterprise or Chef Infra Client Legacy Migration, enter the following:

```bash
wget --content-disposition https://chefdownload-commercial.chef.io/<CHANNEL>/<PRODUCT>/download?p=<PLATFORM>&pm=<PACKAGE_MANAGER>&m=<ARCHITECTURE>&license_id=<LICENSE_ID>
```
11 changes: 10 additions & 1 deletion content/download/community.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,7 @@ The Chef Community Download API has the following endpoints:
- `/versions/latest`
- `/metadata`
- `/download`
- `/fileName`

See the [parameters section](#parameters) below to understand the query strings used in the following endpoint descriptions.

Expand Down Expand Up @@ -114,6 +115,14 @@ The `download` endpoint downloads a particular package of a Chef product.
https://chefdownload-community.chef.io/stable/<PRODUCT>/download?p=<PLATFORM>&pv=<PLATFORM_VERSION>&m=<ARCHITECTURE>&v=<PRODUCT_VERSION>&license_id=<LICENSE_ID>
```

### fileName

The `fileName` endpoint returns the file name.

```plain
https://chefdownload-community.chef.io/<CHANNEL>/<PRODUCT>/fileName?p=<PLATFORM>&pv=<PLATFORM_VERSION>&m=<ARCHITECTURE>&v=<PRODUCT_VERSION>&license_id=<LICENSE_ID>
```

## Parameters

The API accepts the following parameters in a query string.
Expand Down Expand Up @@ -196,7 +205,7 @@ version "14.15.6"

### Download directly

To use cURL to download a package directly, enter the following:
To use curl to download a package directly, enter the following:

```bash
curl -LOJ 'https://chefdownload-community.chef.io/stable/<PRODUCT>/download?p=<PLATFORM>&pv=<PLATFORM_VERSION>&m=<ARCHITECTURE>&license_id=<LICENSE_ID>'
Expand Down