docs/archived/v0.21-docs/reference/index.xml

98 lines
6.5 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
<channel>
<title>Knative Knative Reference Documentation</title>
<link>https://knative.dev/v0.21-docs/reference/</link>
<description>Recent content in Knative Reference Documentation on Knative</description>
<generator>Hugo -- gohugo.io</generator>
<atom:link href="https://knative.dev/v0.21-docs/reference/index.xml" rel="self" type="application/rss+xml" />
<item>
<title>V0.21-Docs: Knative Release Notes</title>
<link>https://knative.dev/v0.21-docs/reference/relnotes/</link>
<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
<guid>https://knative.dev/v0.21-docs/reference/relnotes/</guid>
<description>
&lt;p&gt;For details about the Knative releases, see the following pages:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&#34;https://github.com/knative/serving/releases&#34;&gt;Knative Serving releases&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&#34;https://github.com/knative/serving-operator/releases&#34;&gt;Knative Serving Operator releases&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&#34;https://github.com/knative/client/releases&#34;&gt;Knative CLI releases&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&#34;https://github.com/knative/eventing/releases&#34;&gt;Knative Eventing releases&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
</description>
</item>
<item>
<title>V0.21-Docs: Knative API Reference Documentation</title>
<link>https://knative.dev/v0.21-docs/reference/api/</link>
<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
<guid>https://knative.dev/v0.21-docs/reference/api/</guid>
<description>
</description>
</item>
<item>
<title>V0.21-Docs: Additional resources</title>
<link>https://knative.dev/v0.21-docs/reference/resources/</link>
<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
<guid>https://knative.dev/v0.21-docs/reference/resources/</guid>
<description>
&lt;p&gt;This page contains information about various tools and technologies that are
useful to anyone developing on Knative.&lt;/p&gt;
&lt;h3 id=&#34;kohttpsgithubcomgoogleko&#34;&gt;&lt;a href=&#34;https://github.com/google/ko&#34;&gt;&lt;code&gt;ko&lt;/code&gt;&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;&lt;code&gt;ko&lt;/code&gt; is a tool designed to make development of Go apps on Kubernetes easier, by
abstracting away the container image being used, and instead referring to Go
packages by their &lt;a href=&#34;https://golang.org/doc/code.html#ImportPaths&#34;&gt;import paths&lt;/a&gt;
(e.g., &lt;code&gt;github.com/kaniko/serving/cmd/controller&lt;/code&gt;)&lt;/p&gt;
&lt;p&gt;The typical usage is &lt;code&gt;ko apply --filename config.yaml&lt;/code&gt;, which reads in the
config YAML, and looks for Go import paths representing runnable commands (i.e.,
&lt;code&gt;package main&lt;/code&gt;). When it finds a matching import path, &lt;code&gt;ko&lt;/code&gt; builds the package
using &lt;code&gt;go build&lt;/code&gt; then pushes a container image containing that binary on top of
a base image (by default, &lt;code&gt;gcr.io/distroless/base&lt;/code&gt;) to
&lt;code&gt;$KO_DOCKER_REPO/unique-string&lt;/code&gt;. After pushing those images, &lt;code&gt;ko&lt;/code&gt; replaces
instances of matched import paths with fully-qualified references to the images
it pushed.&lt;/p&gt;
&lt;p&gt;So if &lt;code&gt;ko apply&lt;/code&gt; was passed this config:&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre style=&#34;background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4&#34;&gt;&lt;code class=&#34;language-yaml&#34; data-lang=&#34;yaml&#34;&gt;&lt;span style=&#34;color:#000&#34;&gt;---&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;&lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;image&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;github.com/my/repo/cmd/foo&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&amp;hellip;it would produce YAML like:&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre style=&#34;background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4&#34;&gt;&lt;code class=&#34;language-yaml&#34; data-lang=&#34;yaml&#34;&gt;&lt;span style=&#34;color:#000&#34;&gt;---&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;&lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;image&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;gcr.io/my-docker-repo/foo-zyxwvut@sha256:abcdef&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#8f5902;font-style:italic&#34;&gt;# image by digest&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;(This assumes that you have set the environment variable
&lt;code&gt;KO_DOCKER_REPO=gcr.io/my-docker-repo&lt;/code&gt;)&lt;/p&gt;
&lt;p&gt;&lt;code&gt;ko apply&lt;/code&gt; then passes this generated YAML config to &lt;code&gt;kubectl apply&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;&lt;code&gt;ko&lt;/code&gt; also supports:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;ko publish&lt;/code&gt; to simply push images and not produce configs.&lt;/li&gt;
&lt;li&gt;&lt;code&gt;ko resolve&lt;/code&gt; to push images and output the generated configs, but not
&lt;code&gt;kubectl apply&lt;/code&gt; them.&lt;/li&gt;
&lt;li&gt;&lt;code&gt;ko delete&lt;/code&gt; to simply passthrough to &lt;code&gt;kubectl delete&lt;/code&gt; for convenience.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;code&gt;ko&lt;/code&gt; is used during development and release of Knative components, but is not
intended to be required for &lt;em&gt;users&lt;/em&gt; of Knative &amp;ndash; they should only need to
&lt;code&gt;kubectl apply&lt;/code&gt; released configs generated by &lt;code&gt;ko&lt;/code&gt;.&lt;/p&gt;
</description>
</item>
</channel>
</rss>