Spec-Zone.ru › Chef 16

нож супермаркет

[edit on GitHub]

Подкоманда knife supermarket используется для взаимодействия с кулинарными книгами, которые находятся на публичном супермаркете, а также на частных сайтах супермаркета Chef. Для любых действий в сообществе, которые записывают данные в супермаркет Chef, требуется учетная запись пользователя; однако для следующих аргументов учетная запись пользователя не требуется: download, search, install, и list.

Примечание

Пожалуйста, рассмотрите возможность управления кулинарными книгами сообщества с помощью версии Berkshelf, поставляемой с Chef Workstation. Дополнительную информацию о Chef Workstation см. в разделе О Chef Workstation.

Примечание

Просмотрите список общих параметров, доступных для этой (и всех) подкоманд и плагинов knife.

download

Используйте аргумент download для загрузки кулинарной книги из супермаркета Chef. Кулинарная книга будет загружена в формате архива tar.gz и помещена в текущую рабочую директорию. Если кулинарная книга (или версия кулинарной книги) устарела, и параметр --force не используется, knife предупредит пользователя о том, что кулинарная книга устарела, а затем предоставит имя последней не устаревшей версии этой кулинарной книги.

Синтаксис

Этот аргумент имеет следующий синтаксис:

knife supermarket download COOKBOOK_NAME [COOKBOOK_VERSION] (options)

Параметры

Этот аргумент имеет следующие параметры:

COOKBOOK_VERSION

Версия кулинарной книги, которая должна быть загружена. Если у кулинарной книги только одна версия, этот параметр указывать не нужно. Если у кулинарной книги более одной версии, и этот параметр не указан, загружается последняя версия кулинарной книги.

-f FILE, --file FILE

Файл, в который будет записана загруженная кулинарная книга.

--force

Перезаписать существующую директорию.

-m, --supermarket-site

URL расположения супермаркета Chef. Значение по умолчанию: https://supermarket.chef.io.

Примеры

В следующих примерах показано, как использовать эту подкоманду knife:

Загрузка кулинарной книги

Для загрузки кулинарной книги mysql, введите:

knife supermarket download mysql

install

Используйте аргумент install для установки кулинарной книги, загруженной из супермаркета Chef, в локальный репозиторий git. Это действие использует систему управления версиями git в сочетании с сайтом супермаркета Chef для установки кулинарных книг, предоставленных сообществом, в локальный chef-repo. Использование этого аргумента выполняет следующие действия:

  1. В git создается новая ветка “pristine copy” для отслеживания исходного кода.
  2. Все существующие версии кулинарной книги удаляются из ветки.
  3. Кулинарная книга загружается из супермаркета Chef в формате tar.gz.
  4. Загруженная кулинарная книга распаковывается, ее содержимое коммитится в git, и создается тэг.
  5. Ветка “pristine copy” объединяется с веткой master.

Этот процесс позволяет изменять исходную кулинарную книгу в ветке master, позволяя git поддерживать изменения в виде отдельного патча. При появлении обновленной версии исходного кода эти изменения можно объединить, сохраняя любые локальные модификации.

Синтаксис

Этот аргумент имеет следующий синтаксис:

knife supermarket install COOKBOOK_NAME [COOKBOOK_VERSION] (options)

Параметры

Этот аргумент имеет следующие параметры:

-b, --use-current-branch

Убедиться, что используется текущая ветка.

-B BRANCH, --branch BRANCH

Имя ветки по умолчанию. По умолчанию это ветка master.

COOKBOOK_VERSION

Версия кулинарной книги, которую нужно установить. Если версия не указана, устанавливается последняя версия кулинарной книги.

-D, --skip-dependencies

Убедиться, что все кулинарные книги, от которых установленная кулинарная книга зависит, не установлены.

-m, --supermarket-site

URL расположения супермаркета Chef. Значение по умолчанию: https://supermarket.chef.io.

-o PATH:PATH, --cookbook-path PATH:PATH

Директория, в которой создаются кулинарные книги. Это может быть путь, разделенный двоеточием.

Примеры

В следующих примерах показано, как использовать эту подкоманду knife:

Установка кулинарной книги

Для установки кулинарной книги mysql, введите:

knife supermarket install mysql

list

Используйте аргумент list для просмотра списка кулинарных книг, которые в данный момент доступны на супермаркете Chef.

Синтаксис

Этот аргумент имеет следующий синтаксис:

knife supermarket list (options)

Параметры

Этот аргумент имеет следующие параметры:

-m, --supermarket-site

URL расположения супермаркета Chef. Значение по умолчанию: https://supermarket.chef.io.

-w, --with-uri

Показать соответствующие URI.

Примеры

В следующих примерах показано, как использовать эту подкоманду knife:

Просмотр списка кулинарных книг

Для просмотра списка кулинарных книг на сервере супермаркета Chef, введите:

knife supermarket list

чтобы получить список, похожий на:

1password                            minecraft
301                                  mineos
7-zip                                minidlna
AWS_see_spots_run                    minitest
AmazonEC2Tag                         minitest-handler
Appfirst-Cookbook                    mirage
CVE-2014-3566-poodle                 mlocate
CVE-2015-0235                        mod_security
Obfsproxy                            mod_security2
R                                    modcloth-hubot
Rstats                               modcloth-nad
SysinternalsBginfo                   modman
VRTSralus                            modules
abiquo                               mogilefs
acadock                              mongodb
accel-ppp                            mongodb-10gen
accounts                             mongodb-agents
accumulator                          monit
...

search

Используйте аргумент search для поиска кулинарных книг на супермаркете Chef. Запрос поиска используется для возврата списка этих кулинарных книг и использует тот же синтаксис, что и подкоманда knife search.

Синтаксис

Этот аргумент имеет следующий синтаксис:

knife supermarket search SEARCH_QUERY (options)

Параметры

Этот аргумент имеет следующие параметры:

-m, --supermarket-site

URL расположения супермаркета Chef. Значение по умолчанию: https://supermarket.chef.io.

Примеры

В следующих примерах показано, как использовать эту подкоманду knife:

Поиск кулинарных книг

Для поиска кулинарной книги используйте команду, похожую на:

knife supermarket search mysql

где mysql — поисковый термин. Это вернёт что-то подобное:

mysql:
  cookbook:             https://supermarket.chef.io/api/v1/cookbooks/mysql
  cookbook_description: Provides mysql_service, mysql_config, and mysql_client resources
  cookbook_maintainer:  chef
  cookbook_name:        mysql
mysql-apt-config:
  cookbook:             https://supermarket.chef.io/api/v1/cookbooks/mysql-apt-config
  cookbook_description: Installs/Configures mysql-apt-config
  cookbook_maintainer:  tata
  cookbook_name:        mysql-apt-config
mysql-multi:
  cookbook:             https://supermarket.chef.io/api/v1/cookbooks/mysql-multi
  cookbook_description: MySQL replication wrapper cookbook
  cookbook_maintainer:  rackops
  cookbook_name:        mysql-multi

share

Используйте аргумент share для добавления кулинарной книги в супермаркет Chef. Для этого действия потребуется учетная запись пользователя и сертификат для супермаркета Chef. По умолчанию knife будет использовать имя пользователя и API-ключ, указанные в файле конфигурации, используемом при загрузке; в противном случае эти значения должны быть указаны в командной строке или в альтернативном файле конфигурации. Если кулинарная книга уже существует в супермаркете Chef, то только владелец или основной разработчик этой кулинарной книги могут вносить изменения.

Синтаксис

Этот аргумент имеет следующий синтаксис:

knife supermarket share COOKBOOK_NAME CATEGORY (options)

Параметры

Этот аргумент имеет следующие параметры:

CATEGORY

Категория кулинарной книги: "Databases", "Web Servers", "Process Management", "Monitoring & Trending", "Programming Languages", "Package Management", "Applications", "Networking", "Operating Systems & Virtualization", "Utilities", или "Other".

-m, --supermarket-site

URL расположения супермаркета Chef. Значение по умолчанию: https://supermarket.chef.io.

-o PATH:PATH, --cookbook-path PATH:PATH

Директория, в которой создаются кулинарные книги. Это может быть путь, разделенный двоеточием.

Примеры

В следующих примерах показано, как использовать эту подкоманду knife:

Добавление кулинарной книги в супермаркет

Для добавления кулинарной книги под названием my_apache2_cookbook и добавления ее в категорию Web Servers в супермаркете Chef:

knife supermarket share "my_apache2_cookbook" "Web Servers"

show

Используйте аргумент show для просмотра информации о кулинарной книге на супермаркете Chef.

Синтаксис

Этот аргумент имеет следующий синтаксис:

knife supermarket show COOKBOOK_NAME [COOKBOOK_VERSION] (options)

Параметры

Этот аргумент имеет следующие параметры:

COOKBOOK_VERSION

Версия кулинарной книги для отображения. Если у кулинарной книги только одна версия, этот параметр указывать не нужно. Если у кулинарной книги более одной версии, и этот параметр не указан, возвращается список версий кулинарной книги.

-m, --supermarket-site

URL расположения супермаркета Chef. Значение по умолчанию: https://supermarket.chef.io.

Примеры

В следующих примерах показано, как использовать эту подкоманду knife:

Просмотр данных о кулинарной книге

Чтобы просмотреть подробности о кулинарной книге под названием mysql:

knife supermarket show mysql

чтобы получить что-то подобное:

average_rating:
category:        Other
created_at:      2009-10-28T19:16:54.000Z
deprecated:      false
description:     Provides mysql_service, mysql_config, and mysql_client resources
external_url:    https://github.com/chef-cookbooks/mysql
issues_url:      https://github.com/chef-cookbooks/mysql/issues
latest_version:  https://supermarket.chef.io/api/v1/cookbooks/mysql/versions/8.5.1
maintainer:      sous-chefs
metrics:
  collaborators: 2
  downloads:
    total:    128998032
  versions:
    0.10.0: 927561
    0.15.0: 927536
    0.20.0: 927321
    0.21.0: 927298
    0.21.1: 927311
    0.21.2: 927424
    0.21.3: 927441
    0.21.5: 927326
    0.22.0: 927297
    0.23.0: 927353
    0.23.1: 927862
    0.24.0: 927316

Просмотр данных о версии кулинарной книги

Чтобы просмотреть данные о версии кулинарной книги, выполните команду, аналогичную:

knife supermarket show mysql 8.5.1

где mysql — кулинарная книга, а 8.5.1 — версия кулинарной книги. Это вернёт что-то подобное:

average_rating:
cookbook:          https://supermarket.chef.io/api/v1/cookbooks/mysql
file:              https://supermarket.chef.io/api/v1/cookbooks/mysql/versions/8.5.1/download
license:           Apache-2.0
published_at:      2017-08-23T19:01:28Z
quality_metrics:
  failed:   false
  feedback: passed the No Binaries metric. Contains no obvious binaries.
  name:     No Binaries

  failed:   false
  feedback: mysql passed the publish metric
  name:     Publish

  failed:   false
  feedback: mysql supports at least one platform.
  name:     Supported Platforms

  failed:   false
  feedback: passed the Collaborators Metric with 2 collaborators.
  name:     Collaborator Number

  failed:   false
  feedback:
  Run with Foodcritic Version 14.0.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
  name:     Foodcritic

  failed:   false
  feedback: passed the CONTRIBUTING.md file metric.
  name:     Contributing File

  failed:   false
  feedback: passed the version tag metric.
  name:     Version Tag

  failed:   false
  feedback: passed the TESTING.md file metric.
  name:     Testing File
supports:
  amazon:       >= 0.0.0
  centos:       >= 6.0
  debian:       >= 7.0
  fedora:       >= 0.0.0
  opensuseleap: >= 0.0.0
  oracle:       >= 6.0
  redhat:       >= 6.0
  scientific:   >= 6.0
  suse:         >= 12.0
  ubuntu:       >= 12.04
tarball_file_size: 23763
version:           8.5.1

unshare

Используйте аргумент unshare для прекращения публикации кулинарной книги, расположенной в супермаркете Chef. Это действие может выполнить только владелец кулинарной книги.

Примечание

Удаление кулинарной книги нарушит кулинарную книгу, которая установила зависимость от этой кулинарной книги или версии кулинарной книги.

Синтаксис

Этот аргумент имеет следующий синтаксис:

knife supermarket unshare COOKBOOK_NAME/versions/VERSION (options)

Параметры

Этот аргумент имеет следующие параметры:

-m, --supermarket-site

URL расположения супермаркета Chef. Значение по умолчанию: https://supermarket.chef.io.

Примеры

В следующих примерах показано, как использовать эту подкоманду knife:

Удаление кулинарной книги из супермаркета

Чтобы убрать совместный доступ к кулинарной книге под названием my_apache2_cookbook, введите:

knife supermarket unshare "my_apache2_cookbook" "Web Servers"

Убрать совместный доступ к версии кулинарной книги

Чтобы убрать совместный доступ к версии кулинарной книги 0.10.0 для кулинарной книги my_apache2_cookbook, введите:

knife supermarket unshare "my_apache2_cookbook/versions/0.10.0"

© Chef Software, Inc.
Licensed under the Creative Commons Attribution 3.0 Unported License.
The Chef™ Mark and Chef Logo are either registered trademarks/service marks or trademarks/servicemarks of Chef, in the United States and other countries and are used with Chef Inc's permission.
We are not affiliated with, endorsed or sponsored by Chef Inc.
https://docs.chef.io/knife_supermarket/

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API