معرفی شرکت ها
damster-0.2.1
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Reports and metrics for Atlassian Tools
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | damster-0.2.1 |
| نام | damster |
| نسخه کتابخانه | 0.2.1 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Xabier Davila |
| ایمیل نویسنده | davila.xabier@gmail.com |
| آدرس صفحه اصلی | - |
| آدرس اینترنتی | https://pypi.org/project/damster/ |
| مجوز | Apache License 2.0 |
# Damster
> _Damster_ Builder of dams for logging purposes
Damster is a collection of scripts to collect metrics and reports from Atlassian tools.
This is a WIP, starting with some reports from Bamboo and Confluence:
* Bamboo
* **builds:** All builds for a specific time period
* **deployments:** All deployments for a specific time period
* **deployment-permissions:** Permissions per deployment project and environment
* Confluence
* **changes**: changes in Confluence content in the specific period
Most fo this reports will produce 3 files:
* `.json` contains the raw data used for the report.
* `.csv` contains the above data 'flattened' as csv
* `.html` is a more visual representation of the report
The output location for this files can be defined in the configuration:
```ini
[Reports]
destination_folder=C:\work\damster\globalitconfluence
```
# Usage
Create a virtualenv and install `damster`, either from source or from PyPi:
```bash
$ virtualenv .env
$ source .env/bin/activate
(.env) $ pip install damster # Install from PyPi
(.env) $ pip install -e ./path/to/damster # Install from source
```
For specific instructions on how to use a report, you can request help form the cli:
```bash
(.env) $ damster bamboo builds --help
Usage: damster bamboo builds [OPTIONS] FROM_DATE [TO_DATE]
Generate a builds report
Options:
--use-cache / --no-use-cache
--help Show this message and exit.
```
# Configuration
There are 3 levels of configuration files that can override settings from the previous level:
1. Package defaults, stored in `damster/deaults.cfg`. This file contains the whole set of available
settings and is a good default for your development install.
2. User settings, from `~/.config/damster.cfg` can be used to store user specific settings, like secrets, etc
3. Per-use settings, passes as an argument to damster in each call to the command line:
```bash
(.env) $ damster -c path/to/bamboo-prod.cfg bamboo builds
```
Some of the reports use the REST API for retrieving dat, while others will try to connect directly to the
database. For the REST API reports you will need to provide a user credentials with sufficient permissions,
while for the database reports you will need the credentials of a user with, at least, `SELECT` privileges
on the corresponding database.
## Database configuration
In order to use any of the queries that access directly to the database, you will need to provide a database
configuration section.
### Direct connection
Use this settings if you can connect directly to the DB port
```ini
[Confluence DB]
dbname=confluence
dbuser=confluence
password=password1
host=dbhost.example.com
port=5432
```
### Use SSH tunnel
Use this configuration when you can not access the DB directly, for example, if your DB is an
RDS instance in AWS:
```
----------------------------------------------------------------------
|
-------------+ | +---------+ +--------+
LOCAL | | | APP | | RDS |
CLIENT | <== SSH ======> | SERVER | <== Sec ==> | SERVER |
-------------+ | +---------+ Group +--------+
|
AWS (only access to port 22 on app.server)
----------------------------------------------------------------------
```
Example configuration for the above case:
```ini
[Confluence DB]
dbname=confluence
dbuser=confluence
password=password1
ssh_gateway=app.server
host=rds.server
port=5432
```
Additionally, you may also need an SSH section, if the defaults (below) do not work for your case:
```ini
[SSH]
; All below values are optional. Examples are the default values
;ssh_username: current_user
;ssh_private_key: id_rsa
;port: 22
;local_bind_port: 6543
```
Don't forget to instruct `damster` to use the ssh gateway by adding the `-S` flag:
```bash
(.env) $ damster -c myconfig.cfg confluence changes -S
```
نیازمندی
| مقدار | نام |
|---|---|
| - | configparser |
| - | arrow |
| - | click |
| - | atlassian-python-api |
| - | arrow |
| - | influxdb |
| - | schedule |
| - | jinja2 |
| - | psycopg2 |
| - | sshtunnel |
| - | six |
| xtr | pytest; |
| xtr | pytest-pep8; |
| xtr | coverage; |
| xtr | tox; |
نحوه نصب
نصب پکیج whl damster-0.2.1:
pip install damster-0.2.1.whl
نصب پکیج tar.gz damster-0.2.1:
pip install damster-0.2.1.tar.gz