Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Connessione a Jira Cloud Jira Cloud è una piattaforma sviluppata da Atlassian. La piattaforma include prodotti per il monitoraggio dei problemi che aiutano i team a pianificare e monitorare i progetti Agile. Se sei un utente Jira Cloud, l'account contiene dati sui tuoi progetti, ad esempio problemi, flussi di lavoro ed eventi. Puoi utilizzarlo AWS Glue per trasferire i dati di Jira Cloud a determinati AWS servizi o altre applicazioni supportate. **Topics** + [AWS Glue supporto per Jira Cloud](jira-cloud-support.md) + [Policy contenenti le operazioni API per creare e utilizzare le connessioni](jira-cloud-configuring-iam-permissions.md) + [Configurazione Jira Cloud](jira-cloud-configuring.md) + [Configurazione delle connessioni Jira Cloud](jira-cloud-configuring-connections.md) + [Lettura da entità Jira Cloud](jira-cloud-reading-from-entities.md) + [Opzioni di connessione Jira Cloud](jira-cloud-connection-options.md) + [Limitazioni e note per il connettore Jira Cloud](jira-cloud-connector-limitations.md) # AWS Glue supporto per Jira Cloud AWS Glue supporta Jira Cloud come segue: **Supportato come origine?** Sì. Puoi utilizzare i job AWS Glue ETL per interrogare i dati da Jira Cloud. **Supportato come destinazione?** No. **Versioni dell'API Jira Cloud supportate** Sono supportate le seguenti versioni API Jira Cloud: + v3 Per il supporto delle entità per versione specifica, consulta [Lettura da entità Jira Cloud](jira-cloud-reading-from-entities.md). # Policy contenenti le operazioni API per creare e utilizzare le connessioni La seguente policy di esempio descrive le autorizzazioni AWS IAM richieste per la creazione e l'utilizzo delle connessioni. Se si sta creando un nuovo ruolo, creare una policy che contenga quanto segue: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "glue:ListConnectionTypes", "glue:DescribeConnectionType", "glue:RefreshOAuth2Tokens", "glue:ListEntities", "glue:DescribeEntity" ], "Resource": "*" } ] } ``` ------ In alternativa, se non desideri utilizzare il metodo precedente, utilizza le seguenti policy IAM gestite: + [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Garantisce l'accesso alle risorse che AWS Glue i vari processi richiedono per l'esecuzione per conto dell'utente. Queste risorse includono AWS Glue Amazon S3, IAM, CloudWatch Logs e Amazon. EC2 Se segui la convenzione di denominazione delle risorse specificata in questa politica, AWS Glue i processi dispongono delle autorizzazioni richieste. Questa policy è in genere collegata ai ruoli specificati quando si definiscono crawler, processi ed endpoint di sviluppo. + [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Concede l'accesso completo alle AWS Glue risorse quando un'identità a cui è allegata la policy utilizza la AWS console di gestione. Se si segue la convenzione per la denominazione per le risorse specificate nella policy, gli utenti hanno la piena funzionalità della console. Questa policy è in genere associata agli utenti della AWS Glue console. # Configurazione Jira Cloud Prima di poterli utilizzare AWS Glue per trasferire dati da Jira Cloud alle destinazioni supportate, devi soddisfare questi requisiti: ## Requisiti minimi I requisiti minimi sono i seguenti: + Hai un account Atlassian in cui utilizzi il prodotto software Jira in Jira Cloud. Per ulteriori informazioni, consulta [Creazione di un account Jira Cloud](#jira-cloud-configuring-creating-jira-cloud-account). + È necessario disporre di un AWS account creato con il servizio di accesso a AWS Glue. + Questa app fornisce le credenziali del client che AWS Glue utilizza per accedere ai tuoi dati in modo sicuro quando effettua chiamate autenticate al tuo account. Per ulteriori informazioni, consulta [Enabling OAuth 2.0 (3LO)](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/#enabling-oauth-2-0--3lo-) nella documentazione di Atlassian Developer. Se soddisfi questi requisiti, sei pronto per connetterti AWS Glue al tuo account Jira Cloud. ## Creazione di un account Jira Cloud Per creare un account Jira Cloud: 1. Vai all'[URL di registrazione di Atlassian](https://id.atlassian.com/signup). 1. Inserisci l'e-mail di lavoro e il tuo nome, quindi scegli **Accetto**. Riceverai un'e-mail di verifica. 1. Dopo aver verificato la tua e-mail, puoi creare una password e scegliere **Registrati**. 1. Immetti il nome utente e la password, quindi scegli **Registrati**. 1. Verrai reindirizzato a una pagina in cui è necessario accedere al sito. Inserisci il nome del sito e scegli **Accetto**. Una volta avviato il sito Atlassian Cloud, puoi configurare Jira rispondendo ad alcune domande in base alle preferenze del tipo di progetto. Per accedere a un account esistente: 1. Vai all'[URL di accesso di Atlassian](https://id.atlassian.com/login) e inserisci le credenziali. 1. Inserisci e-mail e password e fai clic su **Accedi**. Verrai reindirizzato alla dashboard Jira. ## Creazione di un'app su Jira Cloud Per creare un'app su Jira Cloud e ottenere l'ID client e il segreto client dall'app client gestita: 1. Vai all'[URL di Jira Cloud](https://id.atlassian.com/login) e inserisci le credenziali. 1. Scegli **Crea** e seleziona l'opzione di **integrazione OAuth 2.0**. 1. Inserisci il nome dell'app, controlla **Termini e condizioni** e scegli **Crea**. 1. Vai alla sezione **Distribuzione** nel menu a sinistra e scegli **Modifica**. 1. Nella sezione **Modifica i controlli di distribuzione**: 1. Seleziona **STATO DISTRIBUZIONE** come **Condivisione**. 1. Inserisci il nome del fornitore. 1. Inserisci l'URL per la tua **Informativa sulla privacy**. Ad esempio, https://docs.aws.amazon.com/glue/ latest/dg/security -iam-awsmanpol.html 1. Inserisci l'URL per i tuoi **Termini di servizio** (facoltativo). 1. Inserisci l'URL del **contatto per l'assistenza clienti** (facoltativo). 1. Seleziona Yes/No dalla **DICHIARAZIONE DEI DATI PERSONALI** e scegli **Salva modifiche**. 1. Vai su **Autorizzazioni** nel menu a sinistra della rispettiva app. 1. Per l'**API Jira**, scegli **Aggiungi**. Una volta aggiunta, scegli l'opzione **Configurazione**. 1. In **Ambiti classici** > **REST API della piattaforma Jira**, scegli **Modifica ambiti** e controlla tutti gli ambiti. Fai clic su **Salva**. 1. In **Ambiti granulari** scegli **Modifica ambiti** e seleziona i seguenti: 1. Scorri verso il basso e trova gli ambiti. È necessario selezionare due tipi di ambiti nelle intestazioni “CRM” e “Standard”. 1. Aggiungi i seguenti ambiti: ``` 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. Vai su **Autenticazione** nel menu a sinistra e scegli **Aggiungi**. 1. Inserisci un **URL di callback** come oauth https://us-east-1.console.aws.amazon.com/gluestudio/ 1. Vai su **Impostazioni** nel menu a sinistra e scorri verso il basso per i dettagli di **autenticazione**. Prendi nota dell'ID client e del segreto. # Configurazione delle connessioni Jira Cloud Jira Cloud supporta il tipo di concessione AUTHORIZATION\$1CODE per. OAuth2 + Questo tipo di concessione è considerato «a tre gambe» in OAuth quanto si basa sul reindirizzamento degli utenti a un server di autorizzazione di terze parti per autenticare l'utente. Viene utilizzato durante la creazione di connessioni tramite la console. AWS Glue La AWS Glue console reindirizzerà l'utente a Jira Cloud, dove l'utente deve effettuare il login e consentire AWS Glue le autorizzazioni richieste per accedere alla propria istanza Jira Cloud. + Gli utenti possono comunque scegliere di creare la propria app connessa in Jira Cloud e fornire il proprio ID client e il segreto del client durante la creazione di connessioni tramite la console. AWS Glue In questo scenario, verranno comunque reindirizzati a Jira Cloud per effettuare il login e autorizzare l'accesso AWS Glue alle proprie risorse. + Questo tipo di concessione genera un token di aggiornamento e un token di accesso. Il token di accesso dura poco tempo e può essere aggiornato automaticamente senza l'interazione dell'utente utilizzando il token di aggiornamento. + Per la documentazione pubblica di Jira Cloud sulla creazione di un'app connessa per il OAuth flusso del codice di autorizzazione, consulta [Enabling OAuth 2.0](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/#enabling-oauth-2-0--3lo-) (3LO). Per configurare una connessione Jira Cloud: 1. In AWS Secrets Manager, crea un segreto con i seguenti dettagli: 1. Per le app connesse gestite dal cliente: il segreto deve contenere l'app connessa Consumer Secret con `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` come chiave. 1. Nota: è necessario creare un segreto per la connessione in AWS Glue. 1. In AWS Glue Glue Studio, crea una connessione in **Connessioni dati** seguendo i passaggi seguenti: 1. In **Tipo di connessione**, seleziona Jira Cloud. 1. Fornisci l'ambiente Jira Cloud. 1. Seleziona il ruolo AWS IAM che AWS Glue può assumere e dispone delle autorizzazioni per le seguenti azioni: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "secretsmanager:DescribeSecret", "secretsmanager:GetSecretValue", "secretsmanager:PutSecretValue", "ec2:CreateNetworkInterface", "ec2:DescribeNetworkInterfaces", "ec2:DeleteNetworkInterface" ], "Resource": "*" } ] } ``` ------ 1. Seleziona quello `secretName` che desideri utilizzare per questa connessione per AWS Glue inserire i token. 1. Selezionare le opzioni di rete se si desidera utilizzare la propria rete. 1. Concedi il permesso di lettura `secretName` al ruolo IAM associato al tuo AWS Glue lavoro. # Lettura da entità Jira Cloud **Prerequisito** Un oggetto di Jira Cloud da cui desideri leggere. È necessario il nome dell'oggetto, come Record audit, o Problema. Nella tabella seguente sono illustrate le entità supportate. **Entità supportate come origine**: | Entità | Può essere filtrato | Supporta limite | Supporta Ordina per | Supporta Seleziona \$1 | Supporta il partizionamento | | --- | --- | --- | --- | --- | --- | | Record audit | Sì | Sì | No | Sì | Sì | | Problema | Sì | Sì | No | Sì | Sì | | Campo Problema | No | No | No | Sì | No | | Configurazione del campo Problema | Sì | Sì | No | Sì | Sì | | Tipo di link del problema | No | No | No | Sì | No | | Schema di notifica del problema | Sì | Sì | No | Sì | Sì | | Schema di sicurezza del problema | No | No | No | Sì | No | | Schema del tipo di problema | Sì | Sì | Sì | Sì | Sì | | Schema del tipo di schermo del problema | Sì | Sì | Sì | Sì | Sì | | Tipo di problema | No | No | No | Sì | No | | Impostazioni Jira | Sì | No | No | Sì | No | | Impostazioni avanzate di Jira | No | No | No | Sì | No | | Impostazioni generali di Jira | No | No | No | Sì | No | | Etichetta | No | No | No | Sì | Sì | | Me stesso | Sì | No | No | Sì | No | | Autorizzazione | No | No | No | Sì | No. | | Progetto | Sì | Sì | Sì | Sì | Sì | | Categoria di progetto | No | No | No | Sì | No | | Tipo di progetto | No | No | No | Sì | No | | Informazioni sul server | No | No | No | Sì | No | | Utenti | No | No | No. | Sì | No | | Flusso di lavoro | Sì | Sì | Sì | Sì | Sì | | Schema del flusso di lavoro | No | Sì | No | Sì | Sì | | Associazione di progetti dello schema del flusso di lavoro | Sì | No | No | Sì | No | | Stato del flusso di lavoro | No | No | No | Sì | No | | Categoria di stato del flusso di lavoro | No | No | No | Sì | No | **Esempio**: ``` jiracloud_read = glueContext.create_dynamic_frame.from_options( connection_type="JiraCloud", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "audit-record", "API_VERSION": "v3" } ``` **Dettagli dell'entità e del campo di Jira Cloud**: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/glue/latest/dg/jira-cloud-reading-from-entities.html) ## Query di partizionamento È possibile fornire l'opzione Spark aggiuntiva `NUM_PARTITIONS` se si desidera utilizzare la simultaneità in Spark. Con questo parametro, la query originale viene suddivisa in `NUM_PARTITIONS` query secondarie che possono essere eseguite contemporaneamente dalle attività Spark. + `NUM_PARTITIONS`: il numero di partizioni. Esempio: ``` jiraCloud_read = glueContext.create_dynamic_frame.from_options( connection_type="JiraCloud", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "issue", "API_VERSION": "v3", "NUM_PARTITIONS": "10" } ``` # Opzioni di connessione Jira Cloud Di seguito sono riportate le opzioni di connessione per Jira Cloud: + `ENTITY_NAME`(String): (obbligatorio) utilizzato per la lettura. Il nome del tuo oggetto in Jira Cloud. + `API_VERSION`(String): (obbligatorio) utilizzato per la lettura. Versione dell'API Rest di Jira Cloud da utilizzare. Ad esempio: v3. + `DOMAIN_URL`(Stringa): (obbligatorio) l'ID Jira Cloud che desideri utilizzare. + `SELECTED_FIELDS`(List): predefinito: vuoto (SELECT \$1). Utilizzato per la lettura. Colonne da selezionare per l'oggetto. + `FILTER_PREDICATE`(Stringa): predefinito: vuoto. Utilizzato per la lettura. Dev'essere in formato Spark SQL. + `QUERY`(Stringa): predefinito: vuoto. Utilizzato per la lettura. Query Spark SQL completa. + `NUM_PARTITIONS`(Integer): predefinito: 1. Utilizzato per la lettura. Numero di partizioni da leggere. # Limitazioni e note per il connettore Jira Cloud Di seguito sono riportate le limitazioni o le note per il connettore Jira Cloud: + L'`Contains`operatore non funziona con il `resourceName` campo, che è di tipo di `String` dati. + Per impostazione predefinita, se non viene applicato alcun filtro esplicito, verranno sottoposti a scansione solo i problemi degli ultimi 30 giorni. Gli utenti hanno la possibilità di sostituire questo filtro predefinito specificando un filtro personalizzato.