Jira Asset Manager

Manage Jira assets in your code or CLI.

• Jira Asset Manager
  • Requirements
  • Install
  • How-to
  • CLI
    • Create assets
    • Update assets
    • Add comment
  • Package
    • Get asset
    • Create asset
    • Update asset
    • Add comment
  • Support 💛
  • Contributing 🤝

Requirements

• Python 3.8+

Install

pip install jira-amt

How-to

You need to add these environment variables to use the CLI:

Variable	Description
JIRA_SERVER	Jira server address like https://jira.domain.com
JIRA_PAT	Your personal access token

After setting these variables, you can configure the CLI:

jira-amt init

This command will get everything from your Jira server and save them to ~/.jira directory for later use. With this data, you don't need to know/use ID of each asset/attribute.

CLI

There is some commands to manage assets. Check them using the --help flag.

Create assets

The asset creation in CLI is not make sense, because you need to enter all attributes in command line. But you can use it in your code.

Update assets

You can update asset's attribute using it's name. The script will get the asset id from the name automatically.

jira-amt attr <schema> <object> <asset name> <attr name> <attr value>
jira-amt attr "ITSM" "Servers" "Server-1" "IP" "1.2.3.4"

Add comment

You can add comment to an asset using it's name. The script will get the asset id from the name automatically.

jira-amt comment <schema> <object> <asset name> <comment>
jira-amt comment "ITSM" "Servers" "Server-1" "This is a comment"

---

Package

You can use this package in your code to manage Jira assets.

from jira_amt.jira import JiraAssetHandler

jira = JiraAssetHandler(
    server="https://jira.domain.com",
    pat="ABCD1234"
)

Get asset

asset = jira.get_asset("schema", "object", "asset's name")

print(asset.text)

Create asset

input = {
    "Name": "Server-1",
    "Status": "Running",
    "Environment": "Production",
    "OS": "Debian",
    "IP": "1.2.3.4"
}

asset = jira.create_asset("schema", "object", input)

Update asset

asset = jira.get_asset("schema", "object", "asset's name")

print(asset.text)

Add comment

result = jira.add_comment("schema", "object", "asset's name", "comment")

print(result.status_code)

Support 💛

Contributing 🤝

Don't be shy and reach out to us if you want to contribute 😉

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin my-new-feature