Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menghubungkan ke Jira Cloud
Jira Cloud adalah platform yang dikembangkan oleh Atlassian. Platform ini mencakup produk pelacakan masalah yang membantu tim merencanakan dan melacak proyek Agile mereka. Sebagai pengguna Jira Cloud, akun Anda berisi data tentang proyek Anda, seperti masalah, alur kerja, dan peristiwa. Anda dapat menggunakan AWS Glue untuk mentransfer data Jira Cloud Anda ke AWS layanan tertentu atau aplikasi lain yang didukung.
**Topics**
+ [AWS Glue dukungan untuk Jira Cloud](jira-cloud-support.md)
+ [Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi](jira-cloud-configuring-iam-permissions.md)
+ [Mengkonfigurasi Jira Cloud](jira-cloud-configuring.md)
+ [Mengkonfigurasi koneksi Jira Cloud](jira-cloud-configuring-connections.md)
+ [Membaca dari entitas Jira Cloud](jira-cloud-reading-from-entities.md)
+ [Opsi koneksi Jira Cloud](jira-cloud-connection-options.md)
+ [Keterbatasan dan catatan untuk konektor Jira Cloud](jira-cloud-connector-limitations.md)
# AWS Glue dukungan untuk Jira Cloud
AWS Glue mendukung Jira Cloud sebagai berikut:
**Didukung sebagai sumber?**
Ya. Anda dapat menggunakan pekerjaan AWS Glue ETL untuk meminta data dari Jira Cloud.
**Didukung sebagai target?**
Tidak.
**Versi Jira Cloud API yang didukung**
Versi API Jira Cloud berikut didukung:
+ v3
Untuk dukungan entitas per versi tertentu, lihat[Membaca dari entitas Jira Cloud](jira-cloud-reading-from-entities.md).
# Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi
Kebijakan contoh berikut menjelaskan izin AWS IAM yang diperlukan untuk membuat dan menggunakan koneksi. Jika Anda membuat peran baru, buat kebijakan yang berisi hal-hal berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
Jika Anda tidak ingin menggunakan metode di atas, gunakan kebijakan IAM terkelola berikut ini:
+ [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Memberikan akses ke sumber daya yang diperlukan berbagai AWS Glue proses untuk dijalankan atas nama Anda. Sumber daya ini termasuk AWS Glue, Amazon S3, IAM, CloudWatch Log, dan Amazon. EC2 Jika Anda mengikuti konvensi penamaan untuk sumber daya yang ditentukan dalam kebijakan ini, AWS Glue proses memiliki izin yang diperlukan. Kebijakan ini biasanya dilampirkan pada peran yang ditentukan saat menentukan crawler, tugas, dan titik akhir pengembangan.
+ [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Memberikan akses penuh ke AWS Glue sumber daya saat identitas yang dilampirkan kebijakan menggunakan Konsol AWS Manajemen. Jika Anda mengikuti konvensi penamaan untuk sumber daya yang ditentukan dalam kebijakan ini, maka pengguna memiliki kemampuan konsol penuh. Kebijakan ini biasanya dilampirkan ke pengguna AWS Glue konsol.
# Mengkonfigurasi Jira Cloud
Sebelum Anda dapat menggunakan AWS Glue untuk mentransfer data dari Jira Cloud ke tujuan yang didukung, Anda harus memenuhi persyaratan berikut:
## Persyaratan minimum
Berikut ini adalah persyaratan minimum:
+ Anda memiliki akun Atlassian tempat Anda menggunakan produk perangkat lunak Jira di Jira Cloud. Untuk informasi selengkapnya, lihat [Membuat akun Jira Cloud](#jira-cloud-configuring-creating-jira-cloud-account).
+ Anda harus memiliki AWS akun yang dibuat dengan akses layanan ke AWS Glue.
+ Aplikasi ini menyediakan kredensi klien yang AWS Glue digunakan untuk mengakses data Anda dengan aman saat melakukan panggilan yang diautentikasi ke akun Anda. Untuk informasi selengkapnya, lihat [Mengaktifkan OAuth 2.0 (3LO) dalam dokumentasi Pengembang](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/#enabling-oauth-2-0--3lo-) Atlassian.
Jika memenuhi persyaratan ini, Anda siap untuk terhubung AWS Glue ke akun Jira Cloud Anda.
## Membuat akun Jira Cloud
Untuk membuat akun Jira Cloud:
1. Arahkan ke [URL pendaftaran Atlassian](https://id.atlassian.com/signup).
1. Masukkan email dan nama kantor Anda dan pilih **Setuju**. Anda menerima email verifikasi.
1. Setelah memverifikasi email Anda, Anda dapat membuat kata sandi dan memilih **Daftar**.
1. Masukkan nama dan kata sandi, lalu pilih **Daftar**.
1. Anda diarahkan ke halaman di mana Anda harus memasukkan situs Anda. Masukkan nama situs dan pilih **Setuju**.
Setelah situs Atlassian Cloud Anda dimulai, Anda dapat mengatur Jira Anda dengan menjawab beberapa pertanyaan sesuai preferensi jenis proyek Anda.
Untuk masuk ke akun yang ada:
1. Arahkan ke [URL login Atlassian](https://id.atlassian.com/login) dan masukkan kredensional.
1. Masukkan email dan kata sandi dan klik **Masuk**. Anda dialihkan ke dasbor Jira.
## Membuat aplikasi di Jira Cloud
Untuk membuat aplikasi di Jira Cloud dan mendapatkan Client ID dan Client Secret dari aplikasi klien terkelola:
1. Arahkan ke [URL Jira Cloud](https://id.atlassian.com/login) dan masukkan kredensional.
1. Pilih **Buat** dan pilih opsi **integrasi OAuth 2.0**.
1. **Masukkan nama aplikasi, periksa **T&C** dan pilih Buat.**
1. Arahkan ke bagian **Distribusi** di menu kiri dan pilih **Edit**.
1. Di bagian **Edit kontrol distribusi**:
1. Pilih **STATUS DISTRIBUSI** sebagai **Berbagi**.
1. Masukkan nama vendor.
1. Masukkan URL untuk **Kebijakan Privasi** Anda. Misalnya, https://docs.aws.amazon.com/glue/ latest/dg/security -iam-awsmanpol.html
1. Masukkan URL untuk **Ketentuan Layanan** Anda (opsional).
1. Masukkan URL untuk **kontak dukungan Pelanggan** Anda (opsional).
1. Pilih Yes/No dari **DEKLARASI DATA PRIBADI** dan pilih **Simpan perubahan**.
1. Arahkan ke **Izin** di menu kiri untuk aplikasi masing-masing.
1. Untuk **JIRA API**, pilih **Tambah**. Setelah ditambahkan, pilih opsi **Konfigurasi**.
1. Di bawah bagian **Classic scopes** > **Jira platform REST API** pilih **Edit Scopes. Dan periksa semua cakupan**. Klik **Simpan**.
1. Di bawah **Lingkup Granular** pilih **Edit Lingkup dan pilih cakupan** berikut:
1. Gulir ke bawah dan temukan cakupan. Ada dua jenis cakupan yang harus Anda pilih di bawah judul “CRM” dan “Standar”.
1. Tambahkan cakupan berikut:
```
read:application-role:jira
read:audit-log:jira
read:avatar:jira
read:field:jira
read:group:jira
read:instance-configuration:jira
read:issue-details:jira
read:issue-event:jira
read:issue-link-type:jira
read:issue-meta:jira
read:issue-security-level:jira
read:issue-security-scheme:jira
read:issue-type-scheme:jira
read:issue-type-screen-scheme:jira
read:issue-type:jira
read:issue.time-tracking:jira
read:label:jira
read:notification-scheme:jira
read:permission:jira
read:priority:jira
read:project:jira
read:project-category:jira
read:project-role:jira
read:project-type:jira
read:project-version:jira
read:project.component:jir
read:project.property:jira
read:resolution:jira
read:screen:jira
read:status:jira
read:user:jira
read:workflow-scheme:jira
read:workflow:jira
read:field-configuration:jira
read:issue-type-hierarchy:jira
read:webhook:jira
```
1. Arahkan ke **Otentikasi** di menu sebelah kiri dan pilih **Tambah**.
1. Masukkan **URL Callback** seperti oauth https://us-east-1.console.aws.amazon.com/gluestudio/
1. Arahkan ke **Pengaturan** di menu kiri dan gulir ke bawah untuk detail **Otentikasi**. Catat ID Klien dan Rahasia.
# Mengkonfigurasi koneksi Jira Cloud
Jira Cloud mendukung jenis hibah AUTHORIZATION\$1CODE untuk. OAuth2
+ Jenis hibah ini dianggap “berkaki tiga” OAuth karena bergantung pada pengalihan pengguna ke server otorisasi pihak ketiga untuk mengautentikasi pengguna. Ini digunakan saat membuat koneksi melalui AWS Glue konsol. AWS Glue Konsol akan mengarahkan pengguna ke Jira Cloud di mana pengguna harus masuk dan mengizinkan izin AWS Glue yang diminta untuk mengakses instance Jira Cloud mereka.
+ Pengguna masih dapat memilih untuk membuat aplikasi mereka sendiri yang terhubung di Jira Cloud dan memberikan ID klien dan rahasia klien mereka sendiri saat membuat koneksi melalui AWS Glue konsol. Dalam skenario ini, mereka masih akan diarahkan ke Jira Cloud untuk masuk dan memberi wewenang AWS Glue untuk mengakses sumber daya mereka.
+ Jenis hibah ini menghasilkan token penyegaran dan token akses. Token akses berumur pendek, dan dapat disegarkan secara otomatis tanpa interaksi pengguna menggunakan token penyegaran.
+ Untuk dokumentasi Jira Cloud publik tentang cara membuat aplikasi yang terhubung untuk OAuth alur Kode Otorisasi, lihat [Mengaktifkan OAuth 2.0 (](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/#enabling-oauth-2-0--3lo-)3LO).
Untuk mengonfigurasi koneksi Jira Cloud:
1. Di AWS Secrets Manager, buat rahasia dengan detail berikut:
1. Untuk aplikasi terhubung yang dikelola pelanggan, Rahasia harus berisi aplikasi yang terhubung Rahasia Konsumen dengan kunci `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` sebagai.
1. Catatan: Anda harus membuat rahasia untuk koneksi di AWS Glue.
1. Di AWS Glue Glue Studio, buat koneksi di bawah **Koneksi Data** dengan mengikuti langkah-langkah di bawah ini:
1. Saat memilih **jenis Koneksi**, pilih Jira Cloud.
1. Menyediakan lingkungan Jira Cloud.
1. Pilih peran AWS IAM yang AWS Glue dapat mengasumsikan dan memiliki izin untuk tindakan berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. Pilih `secretName` yang ingin Anda gunakan untuk koneksi ini AWS Glue untuk memasukkan token.
1. Pilih opsi jaringan jika Anda ingin menggunakan jaringan Anda.
1. Berikan peran IAM yang terkait dengan izin AWS Glue pekerjaan Anda untuk membaca`secretName`.
# Membaca dari entitas Jira Cloud
**Prasyarat**
Objek Jira Cloud yang ingin Anda baca. Anda akan memerlukan nama objek seperti Catatan Audit atau Masalah. Tabel berikut menunjukkan entitas yang didukung.
**Entitas yang didukung untuk sumber**:
| Entitas | Dapat disaring | Mendukung batas | Mendukung Pesanan oleh | Mendukung Pilih \$1 | Mendukung partisi |
| --- | --- | --- | --- | --- | --- |
| Catatan Audit | Ya | Ya | Tidak | Ya | Ya |
| Isu | Ya | Ya | Tidak | Ya | Ya |
| Bidang Masalah | Tidak | Tidak | Tidak | Ya | Tidak |
| Konfigurasi Bidang Masalah | Ya | Ya | Tidak | Ya | Ya |
| Jenis Tautan Masalah | Tidak | Tidak | Tidak | Ya | Tidak |
| Skema Pemberitahuan Masalah | Ya | Ya | Tidak | Ya | Ya |
| Masalah Skema Keamanan | Tidak | Tidak | Tidak | Ya | Tidak |
| Skema Jenis Masalah | Ya | Ya | Ya | Ya | Ya |
| Skema Layar Jenis Masalah | Ya | Ya | Ya | Ya | Ya |
| Jenis Masalah | Tidak | Tidak | Tidak | Ya | Tidak |
| Pengaturan Jira | Ya | Tidak | Tidak | Ya | Tidak |
| Pengaturan Jira Lanjutan | Tidak | Tidak | Tidak | Ya | Tidak |
| Pengaturan Jira Global | Tidak | Tidak | Tidak | Ya | Tidak |
| Label | Tidak | Tidak | Tidak | Ya | Ya |
| Diri saya | Ya | Tidak | Tidak | Ya | Tidak |
| Izin | Tidak | Tidak | Tidak | Ya | Tidak. |
| Proyek | Ya | Ya | Ya | Ya | Ya |
| Kategori Proyek | Tidak | Tidak | Tidak | Ya | Tidak |
| Jenis Proyek | Tidak | Tidak | Tidak | Ya | Tidak |
| Info Server | Tidak | Tidak | Tidak | Ya | Tidak |
| Pengguna | Tidak | Tidak | Tidak. | Ya | Tidak |
| Alur kerja | Ya | Ya | Ya | Ya | Ya |
| Skema Alur Kerja | Tidak | Ya | Tidak | Ya | Ya |
| Asosiasi Proyek Skema Alur Kerja | Ya | Tidak | Tidak | Ya | Tidak |
| Status Alur Kerja | Tidak | Tidak | Tidak | Ya | Tidak |
| Kategori Status Alur Kerja | Tidak | Tidak | Tidak | Ya | Tidak |
**Contoh:**
```
jiracloud_read = glueContext.create_dynamic_frame.from_options(
connection_type="JiraCloud",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "audit-record",
"API_VERSION": "v3"
}
```
**Entitas Jira Cloud dan detail bidang**:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/jira-cloud-reading-from-entities.html)
## Mempartisi kueri
Anda dapat memberikan opsi Spark tambahan `NUM_PARTITIONS` jika Anda ingin menggunakan konkurensi di Spark. Dengan parameter ini, kueri asli akan dibagi menjadi `NUM_PARTITIONS` sejumlah sub-kueri yang dapat dijalankan oleh tugas Spark secara bersamaan.
+ `NUM_PARTITIONS`: jumlah partisi.
Contoh:
```
jiraCloud_read = glueContext.create_dynamic_frame.from_options(
connection_type="JiraCloud",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "issue",
"API_VERSION": "v3",
"NUM_PARTITIONS": "10"
}
```
# Opsi koneksi Jira Cloud
Berikut ini adalah opsi koneksi untuk Jira Cloud:
+ `ENTITY_NAME`(String) - (Diperlukan) Digunakan untuk Baca. Nama objek Anda di Jira Cloud.
+ `API_VERSION`(String) - (Diperlukan) Digunakan untuk Baca. Versi API Jira Cloud Rest yang ingin Anda gunakan. Misalnya: v3.
+ `DOMAIN_URL`(String) - (Diperlukan) ID Jira Cloud yang ingin Anda gunakan.
+ `SELECTED_FIELDS`(Daftar) - Default: kosong (SELECT \$1). Digunakan untuk Baca. Kolom yang ingin Anda pilih untuk objek.
+ `FILTER_PREDICATE`(String) - Default: kosong. Digunakan untuk Baca. Itu harus dalam format Spark SQL.
+ `QUERY`(String) - Default: kosong. Digunakan untuk Baca. Kueri SQL Spark penuh.
+ `NUM_PARTITIONS`(Integer) - Default: 1. Digunakan untuk Baca. Jumlah partisi untuk dibaca.
# Keterbatasan dan catatan untuk konektor Jira Cloud
Berikut ini adalah batasan atau catatan untuk konektor Jira Cloud:
+ `Contains`Operator tidak bekerja dengan `resourceName` bidang, yang merupakan tipe `String` data.
+ Secara default, jika tidak ada filter eksplisit yang diterapkan, hanya masalah dari 30 hari terakhir yang akan dirayapi. Pengguna memiliki opsi untuk mengganti filter default ini dengan menentukan filter khusus.