Utilizzo dei gruppi di report condivisi

La condivisione dei gruppi di report consente a più utenti o account AWS di visualizzare i report non scaduti, con i relativi risultati di test, afferenti a un gruppo di report. In questo modello, l'account titolare (proprietario) condivide il proprio gruppo di report con altri account (consumatori). Un consumatore non può modificare il gruppo di report. Un report scade 30 giorni dopo la creazione.

Prerequisiti per la condivisione dei gruppi di report

L'account AWS deve essere il proprietario del gruppo di report che intende condividere. Un consumatore non può condividere il gruppo di report a cui ha avuto accesso.

Prerequisiti per l'accesso ai gruppi di report condivisi con il consumatore

Un consumatore può accedere a un gruppo di report condiviso solo se il suo ruolo IAM dispone dell'autorizzazione BatchGetReportGroups. Puoi associare al ruolo IAM la policy seguente:

{
    "Effect": "Allow",
    "Resource": [
        "*"
    ],
    "Action": [
        "codebuild:BatchGetReportGroups"
    ]
}

Per ulteriori informazioni, consultare Utilizzo di politiche basate sull'identità per AWS CodeBuild.

Servizi correlati

La condivisione dei gruppi di report si integra con AWS Resource Access Manager (AWS RAM), un servizio che permette di condividere le proprie risorse AWS con qualsiasi account AWS o tramite AWS Organizations. Con AWS RAM, creando una condivisione delle risorse di proprietà, è possibile specificare le risorse e i consumatori interessati. I consumatori possono corrispondere ad account AWS singoli, a unità organizzative in AWS Organizations o anche a un'intera organizzazione in AWS Organizations.

Per ulteriori informazioni, consulta la Guida per l'utente di AWS RAM.

Condivisione di un gruppo di report

Quando si condivide un gruppo di report, al consumatore viene concesso l'accesso in sola lettura al gruppo e ai relativi report. Per visualizzare il gruppo di report con i vari report e i relativi risultati dei casi di test, il consumatore può avvalersi dell'AWS CLI. Il consumatore non può:

• Visualizzare un gruppo di report condiviso o i relativi report nella console di CodeBuild.

• Modificare un gruppo di report condiviso.

• Utilizzare l'ARN del gruppo di report condiviso in un progetto, per eseguire un report. Una compilazione di progetto che specifica un gruppo di report condiviso ha esito negativo.

Puoi utilizzare la console CodeBuild per aggiungere un gruppo di report a una condivisione di risorse esistente. La console AWS RAM, invece, permette di creare appositamente una nuova condivisione di risorse per il gruppo di report.

Per condividere un gruppo di report con unità organizzative o un'intera organizzazione, è necessario abilitare la condivisione con AWS Organizations. Per ulteriori informazioni, consulta Abilitare la condivisione con AWS Organizations nella Guida per l'utente di AWS RAM.

Puoi usare la console CodeBuild,AWS RAMconsole oAWS CLICome condividere gruppi di report che si possiedono.

Come condividere un gruppo di report che si possiede (console CodeBuild)

1. Apertura dellaAWS CodeBuildconsole alhttps://console.aws.amazon.com/codesuite/codebuild/home.

2. Nel riquadro di navigazione, scegliere Report groups (Gruppi di report).

3. Selezionare il progetto da condividere, poi fare clic su Share (Condividi). Per ulteriori informazioni, consulta l'argomento relativo alla creazione di una condivisione di risorse nella Guida per l'utente di AWS RAM.

Come condividere gruppi di report che si possiedono (console AWS RAM)

Consulta .Creare una condivisione di risorsenellaAWS RAMGuida per l’utente di.

Come condividere gruppi di report che si possiedono (comando AWS RAM)

Utilizza il comando create-resource-share.

Come condividere un gruppo di report che si possiede (comando CodeBuild)

Utilizzare il comando put-resource-policy:

1. Creare un file denominato policy.json e copiarvi quanto segue.

   {
      "Version":"2012-10-17",
      "Statement":[{
        "Effect":"Allow",
        "Principal":{
          "AWS":"consumer-aws-account-id-or-user"
        },
        "Action":[
          "codebuild:BatchGetReportGroups",
          "codebuild:BatchGetReports",
          "codebuild:ListReportsForReportGroup",
          "codebuild:DescribeTestCases"],
        "Resource":"arn-of-report-group-to-share"
      }]
    }

2. Aggiornare policy.json con l'ARN del gruppo di report e gli identificatori da coinvolgere nella condivisione. L'esempio seguente concede l'accesso in sola lettura al gruppo di report con l'ARNarn:aws:codebuild:us-west-2:123456789012:report-group/my-report-groupad Alice e l'utente root per ilAWSaccount identificato da 123456789012.

   {
      "Version":"2012-10-17",
      "Statement":[{
        "Effect":"Allow",
        "Principal":{
          "AWS": [
             "arn:aws:iam::123456789012:user/Alice",
             "123456789012"
           ]
        },
        "Action":[
          "codebuild:BatchGetReportGroups",
          "codebuild:BatchGetReports",
          "codebuild:ListReportsForReportGroup",
          "codebuild:DescribeTestCases"],
        "Resource":"arn:aws:codebuild:us-west-2:123456789012:report-group/my-report-group"
      }]
    }

3. Esegui il seguente comando.

   aws codebuild put-resource-policy --resource-arn report-group-arn --policy file://policy.json

Annullamento della condivisione di un gruppo di report

Annullandone la condivisione, a un gruppo di report con i relativi report e risultati dei casi di test può accedere solo il proprietario. Se si annulla la condivisione di un gruppo di report, i profili utente o account AWS precedentemente autorizzati non possono più accedere al gruppo con i relativi report e risultati dei casi di test.

Per annullare, basta rimuovere il gruppo di report di proprietà dalla relativa condivisione di risorse. È possibile effettuare tale operazione mediante la console AWS RAM o tramite AWS CLI.

Come annullare la condivisione di un gruppo di report che si possiede (console AWS RAM)

ConsultaAggiornamento di una condivisione di risorse nella Guida per l'utente di AWS RAM.

Come annullare la condivisione di un gruppo di report che si possiede (comando AWS RAM)

Usa il comando disassociate-resource-share.

Come annullare la condivisione del gruppo di report che si possiede (comando CodeBuild)

Eseguire il comando delete-resource-policy e specificare l'ARN del gruppo di cui si intende annullare la condivisione:

aws codebuild delete-resource-policy --resource-arn report-group-arn

Identificazione di un gruppo di report condiviso

Proprietari e consumatori possono identificare i gruppi di report condivisi con l'AWS CLI.

I comandi seguenti consentono di identificare e ottenere informazioni su un gruppo condiviso e i relativi report:

• Per visualizzare gli ARN dei gruppi di report condivisi con l'utente, bisogna eseguire list-shared-report-groups:

  aws codebuild list-shared-report-groups

• Per visualizzare gli ARN dei report in un gruppo di report, basta eseguire list-reports-for-report-group utilizzando l'ARN del gruppo di report:

  aws codebuild list-reports-for-report-group --report-group-arn report-group-arn

• Per visualizzare le informazioni relative ai casi di test in un report, occorre eseguire describe-test-cases utilizzando l'ARN del report:

  aws codebuild describe-test-cases --report-arn report-arn

  L'output sarà simile al seguente:

  {
      "testCases": [
          {
              "status": "FAILED",
              "name": "Test case 1",
              "expired": 1575916770.0,
              "reportArn": "report-arn",
              "prefix": "Cucumber tests for agent",
              "message": "A test message",
              "durationInNanoSeconds": 1540540,
              "testRawDataPath": "path-to-output-report-files"
          },
          {
              "status": "SUCCEEDED",
              "name": "Test case 2",
              "expired": 1575916770.0,
              "reportArn": "report-arn",
              "prefix": "Cucumber tests for agent",
              "message": "A test message",
              "durationInNanoSeconds": 1540540,
              "testRawDataPath": "path-to-output-report-files"
          }
      ]
  }

Autorizzazioni per il gruppo di report condiviso

Autorizzazioni per i proprietari

Un proprietario può modificare il gruppo di report e specificarlo in un progetto per l'esecuzione dei report.

Autorizzazioni per i consumatori

Un consumatore può visualizzare il gruppo con i relativi report e risultati dei casi di test. Un consumatore non può modificare il gruppo di report (o i relativi report) né utilizzarlo per creare altri report.