.. _services/appendice/aws_cli:

AWS CLI
=======




`AWS CLI <https://aws.amazon.com/it/cli/>`_ è l'interfaccia da linea di comando che permette di gestire da prompt dei comandi tutti i servizi di AWS. 

Il dialogo di questa con Genropy avviene sfruttando la Amazon Web Services (AWS) SDK per Python, una libreria contentente un altro package Python fondamentale, **Boto3**.
 
Boto3 sarà già installata di default nei requisiti di Genropy, ma qualora fosse necessario aggiornarla o reinstallarla è sufficiente usare questa linea di comando::

  pip3 install boto3 --user

.. hint::
  L'installazione con ``--user`` garantirà il posizionamento nella *home directory* per evitare problemi di permessi.
  
È poi necessario installare la libreria *awscli* per poter configurare il servizio::

  sudo pip3 install awscli
  
A questo punto, sempre dalla finestra di terminale, è possibile configurare il servizio con le proprie credenziali ottenibili dalla `console AWS <https://aws.amazon.com/it/translate/>`_

::

  aws configure
  
  AWS Access Key ID [****************XXXX]:
  AWS Secret Access Key [****************XXXX]:
  Default region name [us-west-2]:
  Default output format [json]:
  
.. hint::
  Si noti che le credenziali inserite permetteranno l'accesso della macchina a **tutti i servizi**
  
----

Riferimenti: `Configurazione di AWS CLI <https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#configuration>`_

.. sectionauthor:: Davide Paci