summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorOpenShift Merge Robot <openshift-merge-robot@users.noreply.github.com>2020-05-21 16:11:20 +0200
committerGitHub <noreply@github.com>2020-05-21 16:11:20 +0200
commit8b49d10550d32e066bc834768a44d6c848f4db3e (patch)
treec16693e3b50c3a0db74d69cb9016d9a755bdf30c /docs
parent88da5a7d35403c69a25fc3d4f3f6cd0c5a5f4321 (diff)
parent9ceff66a7dc99553afdf59151e1995ed30c9b26c (diff)
downloadpodman-8b49d10550d32e066bc834768a44d6c848f4db3e.tar.gz
podman-8b49d10550d32e066bc834768a44d6c848f4db3e.tar.bz2
podman-8b49d10550d32e066bc834768a44d6c848f4db3e.zip
Merge pull request #6310 from mheon/update_api_tutorial
Update Derivative API tutorial to reflect the HTTP API
Diffstat (limited to 'docs')
-rw-r--r--docs/tutorials/podman-derivative-api.md18
1 files changed, 16 insertions, 2 deletions
diff --git a/docs/tutorials/podman-derivative-api.md b/docs/tutorials/podman-derivative-api.md
index 065b0c4a9..8a1f40fc0 100644
--- a/docs/tutorials/podman-derivative-api.md
+++ b/docs/tutorials/podman-derivative-api.md
@@ -4,6 +4,20 @@
libpod today is a Golang library and a CLI. The choice of interface you make has advantages and disadvantages.
+Using the REST API
+---
+
+Advantages:
+
+ - Stable, versioned API
+ - Language-agnostic
+ - [Well-documented](http://docs.podman.io/en/latest/_static/api.html) API
+
+Disadvantages:
+
+ - Error handling is less verbose than Golang API
+ - May be slower
+
Running as a subprocess
---
@@ -35,12 +49,12 @@ Disadvantages:
Varlink
---
-Some code exists for this; splits the difference. Future uncertain.
+The Varlink API is presently deprecated. We do not recommend adopting it for new projects.
Making the choice
---
A good question to ask first is: Do you want users to be able to use `podman` to manipulate the containers created by your project?
-If so, that makes it more likely that you want to run `podman` as a subprocess. If you want a separate image store and a fundamentally
+If so, that makes it more likely that you want to run `podman` as a subprocess or using the HTTP API. If you want a separate image store and a fundamentally
different experience; if what you're doing with containers is quite different from those created by the `podman` CLI,
that may drive you towards vendoring.