PoshBot

ПошБот

Лазурные трубопроводы	Действия GitHub	Документация	PS Галерея	Лицензия

---

Поддержка PoshBot

PoshBot — это проект с открытым исходным кодом, лицензированный MIT. Постоянное развитие становится возможным благодаря поддержке спонсоров. Если вы хотите стать спонсором, вы можете сделать это через GitHub Sponsors или Patreon.

Серебряные спонсоры

---

Хотите подробные руководства? Ознакомьтесь с ChatOps the Easy Way на Leanpub!

Введение

PoshBot — чат-бот, написанный на PowerShell. Он широко использует классы, представленные в PowerShell 5.0. Модули PowerShell загружаются в PoshBot и мгновенно становятся доступными как команды бота. PoshBot в настоящее время поддерживает подключение к Slack, чтобы предоставить вам потрясающие возможности ChatOps.

Что может PoshBot?

Практически все, что захотите :) Нет, серьезно. PoshBot выполняет функции или командлеты из модулей PowerShell. Используйте PoshBot для подключения к серверам и сообщения о состоянии, развертывания кода, выполнения модулей Runbook, запросов к API и т. д. Если вы можете написать его в PowerShell, PoshBot сможет его выполнить.

Документация

Подробную документацию можно найти на ReadTheDocs.

Создание PoshBot

См. раздел «Сборка PoshBot» для получения документации о том, как собрать PoshBot из исходного кода.

Журнал изменений

Подробные изменения для каждого выпуска описаны в примечаниях к выпуску.

[YouTube] PowerShell Summit 2018 — Invoke-ChatOps: повышайте уровень и меняйте свою культуру с помощью чата и PowerShell

Быстрый старт

Чтобы начать работу прямо сейчас, получите SLACK-API-TOKEN для своего бота:

https://my.slack.com/services/new/bot

 # Install the module from PSGallery
Install-Module - Name PoshBot - Repository PSGallery

# Import the module
Import-Module - Name PoshBot

# Create a bot configuration
$botParams = @ {
    Name = ' name '
    BotAdmins = @ ( ' <SLACK-CHAT-HANDLE> ' )
    CommandPrefix = ' ! '
    LogLevel = ' Info '
    BackendConfiguration = @ {
        Name = ' SlackBackend '
        Token = ' <SLACK-API-TOKEN> '
    }
    AlternateCommandPrefixes = ' bender ' , ' hal '
}

$myBotConfig = New-PoshBotConfiguration @botParams

# Start a new instance of PoshBot interactively or in a job.
Start-PoshBot - Configuration $myBotConfig # -AsJob

Основное использование:

 # Create a Slack backend
$backendConfig = @ { Name = ' SlackBackend ' ; Token = ' <SLACK-API-TOKEN> ' }
$backend = New-PoshBotSlackBackend - Configuration $backendConfig

# Create a PoshBot configuration
$pbc = New-PoshBotConfiguration - BotAdmins @ ( ' <MY-SLACK-HANDLE> ' ) - BackendConfiguration $backendConfig

# Save configuration
Save-PoshBotConfiguration - InputObject $pbc - Path .PoshBotConfig.psd1

# Load configuration
$pbc = Get-PoshBotConfiguration - Path .PoshBotConfig.psd1

# Create an instance of the bot
$bot = New-PoshBotInstance - Configuration $pbc - Backend $backend

# Start the bot
$bot .Start ()

# Available commands
Get-Command - Module PoshBot

CommandType     Name                                               Version    Source
-----------     ----                                               -------    ------
Function        Get-PoshBot                                        0.12.0     poshbot
Function        Get-PoshBotConfiguration                           0.12.0     poshbot
Function        Get-PoshBotStatefulData                            0.12.0     poshbot
Function        New-PoshBotCardResponse                            0.12.0     poshbot
Function        New-PoshBotConfiguration                           0.12.0     poshbot
Function        New-PoshBotDiscordBackend                          0.12.0     poshbot
Function        New-PoshBotFileUpload                              0.12.0     poshbot
Function        New-PoshBotInstance                                0.12.0     poshbot
Function        New-PoshBotMiddlewareHook                          0.12.0     poshbot
Function        New-PoshBotScheduledTask                           0.12.0     poshbot
Function        New-PoshBotSlackBackend                            0.12.0     poshbot
Function        New-PoshBotTeamsBackend                            0.12.0     poshbot
Function        New-PoshBotTextResponse                            0.12.0     poshbot
Function        Remove-PoshBotStatefulData                         0.12.0     poshbot
Function        Save-PoshBotConfiguration                          0.12.0     poshbot
Function        Set-PoshBotStatefulData                            0.12.0     poshbot
Function        Start-PoshBot                                      0.12.0     poshbot
Function        Stop-Poshbot                                       0.12.0     poshbot