mirror of https://github.com/tektoncd/catalog.git synced 2024-11-21 05:55:35 +00:00

History

Quan Zhang e294e1246b [TEP-0110] Update Tekton Catalog installation instructions Prior to this change, the installation instructions directly use the resource urls in the Catalog repo, which results in tight coupling between the organization and how users fetch resources (as described in TEP-0110). This commit updates the installation guide to install Tekton Catalog resources via Tekton Hub Api: https://github.com/tektoncd/hub/pull/539 This change decouples the Tekton Catalog organization from resouces resolution, which enables Tekton Catalog reorganization.		2022-08-16 16:25:52 +01:00
..
tests	Modifies curl task according to the new reorg proposal	2020-07-10 22:06:57 +01:00
curl.yaml	Add platforms annotation to several tasks	2021-10-28 10:17:37 +01:00
README.md	[TEP-0110] Update Tekton Catalog installation instructions	2022-08-16 16:25:52 +01:00

README.md

`curl`

This task performs curl operation to transfer data from internet .

Install the Task

kubectl apply -f https://api.hub.tekton.dev/v1/resource/tekton/task/curl/0.1/raw

Parameters

options: The arguments to pass to curl CLI. default: [""]
url: The url we want to download file from, required field.
curl-image: The curl docker image to be used. Defaults to curlimages/curl.

Platforms

The Task can be run on linux/amd64, linux/s390x, linux/arm64 and linux/ppc64le platforms.

Usage

Running the Task

Viewing request headers and connection details

You can invoke curl -i url to get request header from specified url:

Create a file, curl-header-run.yaml:

apiVersion: tekton.dev/v1beta1
kind: TaskRun
metadata:
  name: curl-header-run
spec:
  params:
    - name: url
      value: "www.google.com"
    - name: options
      value:
       - "-i"
  taskRef:
    name: curl

Run it with kubectl apply -f curl-header-run.yaml

When this runs, it will print logs containing only headers of the response

View full response from request to specified url

You can invoke curl url to get a full response from specified url:

Create a file, curl-reponse-run.yaml:

apiVersion: tekton.dev/v1beta1
kind: TaskRun
metadata:
  name: curl-response-run
spec:
  params:
    - name: url
      value: "www.google.com"
  taskRef:
    name: curl

Run it with kubectl apply -f curl-response-run.yaml

When this runs, it will print logs containing full response fields of the request

Use a different version of curl image

You can invoke curl url to get a full response from specified url while specifying a different image in taskrun:

Create a file, curl-diffimage-run.yaml:

apiVersion: tekton.dev/v1beta1
kind: TaskRun
metadata:
  name: curl-diffimage-run
spec:
  params:
    - name: url
      value: "www.google.com"
    - name: curl-image
      value: "appropriate/curl"
  taskRef:
    name: curl

Run it with kubectl apply -f curl-diffimage-run.yaml

When this runs, it will print logs containing full response fields of the request as in the last example, but now uses a different version of image