mattcasters opened a new pull request, #7920:
URL: https://github.com/apache/hop/pull/7920

   ## What this is
   
   Documentation for [issue #3062](https://github.com/apache/hop/issues/3062): 
after you develop a Hop project, how do you actually get it onto a running Hop 
Server (or decide you do not need one)?
   
   Docs only. No engine or CLI changes.
   
   ## Deployment manual
   
   New section under **Hop Server → Deploying Hop Server**:
   
   - **Overview** (`deploying.adoc`) — project vs environment, comparison 
table, and when a Hop Server is not needed at all.
   - **Project in a Docker image** — CI bakes the project into `FROM 
apache/hop` at `/your-project`. Same image can be:
     - **short-lived**: Airflow / Kubernetes Job / CronJob runs hop-run and 
exits (often the better production pattern). Persist execution information to a 
volume, database, OpenSearch, Neo4j or Elastic.
     - **long-lived**: roll Hop Server with docker run, Compose, Helm, 
Kubernetes or OpenShift.
   - **Remote run with export resources** — bare server; client (hop-run / 
Airflow / Gui) sends a ZIP. Documents what is *not* in the ZIP (env JSON, extra 
config files, JDBC, plugins, large data files) and why named-resource 
source/target folders matter.
   - **Git checkout on the server** — clone, `hop-conf`, `hop-server.sh -e 
prod`, `git pull`, and what needs a restart.
   
   Sample Dockerfile, Compose file, GitHub Actions workflow and systemd unit 
live under `docs/.../assets/files/hop-server/`.
   
   `-e` is enough to start hop-run / hop-server; the project name comes from 
the environment. `HOP_PROJECT_NAME` is still required in Docker because the 
entrypoint *creates* the project before the environment.
   
   ## OpenSearch execution information location
   
   The OpenSearch location type was undocumented. Adds 
`opensearch-location-type.adoc` (options, create-index mapping) and a 
comparison with Elastic: basic auth vs API key, ignore-SSL, `/_plugins/_sql` vs 
`_search`, nested vs dotted mappings. Wired into 
`execution-information-location.adoc`, the metadata index, nav, and the Elastic 
page.
   
   ## Cross-links
   
   Pointers from Hop Server, hop-run, remote run configs, Docker tech manual, 
Helm README, Airflow how-to, web-services how-to, projects, best practices, and 
Getting Started.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to