Questa pagina descrive come eseguire il deployment dell'API.
Prima di iniziare
- Configura l'ambiente di programmazione.
- Crea un'API e annotala.
Distribuzione di un'API
Puoi eseguire il deployment dell'API utilizzando i plug-in Apache Maven o Gradle per App Engine. Per eseguire il deployment della tua API in un ambiente standard di App Engine di produzione, utilizza il comando per il tuo plug-in:
- Utilizza il comando per il tuo plug-in:
Maven
mvn appengine:deploy
Gradle
gradle appengineDeploy
- Attendi il completamento del deployment.
Invia una richiesta di test all'API di cui è stato eseguito il deployment. Ad esempio, utilizzando
curl
:curl \ -H "Content-Type: application/json" \ -X POST \ -d '{"message": "echo"}' \ "https://YOUR-PROJECT-ID.appspot.com/_ah/api/echo/v1/echo?n=2"
La tua risposta è simile alla seguente:
{ "message": "echo echo" }
Se non hai ricevuto una risposta positiva, consulta la sezione Risoluzione dei problemi relativi alle risposte.
Deployment in più versioni dell'applicazione
Per informazioni su come eseguire il controllo delle versioni dell'API e su come eseguire il deployment nelle versioni, consulta Gestione del controllo delle versioni dell'API
Eseguire e testare i backend dell'API in locale
Per testare l'API localmente:
Compila il progetto nella directory principale del progetto. Ad esempio:
Maven
mvn clean package
Gradle
gradle clean build
Avvia il server di sviluppo App Engine. Ad esempio:
Maven
mvn appengine:run
Gradle
gradle appengineRun
Fai una richiesta API per testare l'API. Ad esempio, utilizzando
curl
:curl \ -H "Content-Type: application/json" \ -X POST \ -d '{"message": "echo"}' \ "${HOST}/_ah/api/echo/v1/echo?n=2"
Pubblicazione dell'API da un percorso diverso
Per pubblicare l'API da un percorso diverso, nel file web.xml
modifica url-pattern
nella sezione EndpointsServlet
e reimplementa l'API. Ad
esempio:
<servlet-mapping>
<servlet-name>EndpointsServlet</servlet-name>
<url-pattern>/example-api/*</url-pattern>
</servlet-mapping>
Aggiunta della gestione delle API
Endpoints Frameworks fornisce funzionalità di gestione delle API come:
Affinché la tua API venga gestita dai framework Endpoints, devi generare e implementare un documento OpenAPI che la descriva, come descritto in Aggiunta della gestione delle API.