Skip to content

Conversation

@ahardin-rh
Copy link
Contributor

@ahardin-rh ahardin-rh commented Oct 27, 2017

@ahardin-rh ahardin-rh added this to the Future Release milestone Oct 27, 2017
@ahardin-rh ahardin-rh self-assigned this Oct 27, 2017
@ahardin-rh ahardin-rh force-pushed the ocp-3-7-release-notes branch from f530799 to a4b2ee7 Compare October 27, 2017 20:19
@ahardin-rh ahardin-rh changed the title Added OCP 3.7 Release Notes [WIP}Added OCP 3.7 Release Notes Oct 27, 2017
@ahardin-rh ahardin-rh changed the title [WIP}Added OCP 3.7 Release Notes [WIP]Added OCP 3.7 Release Notes Oct 27, 2017
@ahardin-rh ahardin-rh force-pushed the ocp-3-7-release-notes branch from a4b2ee7 to 748599a Compare October 27, 2017 21:08
@ahardin-rh ahardin-rh force-pushed the ocp-3-7-release-notes branch 7 times, most recently from 96d3634 to 13677bf Compare November 14, 2017 20:27
applications at scale. This is due to the introduction of brick-multiplexing
support in GlusterFS.

Over 1,000 volumes in a 3-node cluster with 32 GB per node available to
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

32 GB per node -> 32 GB RAM per node?


Over 1,000 volumes in a 3-node cluster with 32 GB per node available to
GlusterFS has been successfully tested. Also, 300 Block PVs are supported now on
3-node CNS .
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CNS . -> CNS.

==== CNS Multi-protocol (File, Block, and S3) Support for OpenShift

Container-native storage (CNS) is now extended support iSCSI and S3 back end for
{product-title}. Heketi is enhanced to support persistent volume (PV) expansion,
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The PV resize feature will land in 3.8.

that can be run and output can be sent as file-based output.

----
$ ansible-playbook playbooks/byo/openshift-checks/adhoc.yml
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.


.Namespece-specific Example
----
piVersion: v1

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

apiVersion?

Alternatively, they can use an external provisioner and feed it the node
configuration via `configMaps`.

Example persistent volume named `example-local-pv` that some tenant can now claim:

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

some tenants?

@wkshi
Copy link

wkshi commented Nov 15, 2017

Are we still encourage customers use quick installer in 3.7?
QE has identified that quick installer is totally unable to perform fresh installation in 3.7

Know issues:
https://bugzilla.redhat.com/show_bug.cgi?id=1509112
https://bugzilla.redhat.com/show_bug.cgi?id=1509137

----
$ oc create -f snapshot.yaml
apiVersion: volume-snapshot-data.external-storage.k8s.io/v1

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

apiVersion: volumesnapshot.external-storage.k8s.io/v1

@jiajliu
Copy link

jiajliu commented Nov 15, 2017

  1. some errors about etcd data directory.
    1.1 [Downgrading OpenShift]-[Verifying Backups]
    Error: "/var/lib/origin/etcd-backup-"
    Shouldbe: /var/lib/etcd/openshift-backup-
    1.2 [Backup and Restore]-[Prerequisites], [Embedded etcd]
    Error: embedded etcd's dir is not consistant between [Prerequisites] and [Embedded etcd]

all-in-one cluster
/var/lib/origin/openshift.local.etcd
external etcd (not on master)
/var/lib/etcd
embedded etcd (on master)
/var/lib/etcd

"# ETCD_DIR=/var/lib/origin/openshift.local.etcd"

Shouldbe: From v3.7 there is no embedded etcd now. If older version is embedded etcd, user need to migrate embedded etcd to external etcd first. And we still support two deployed external etcd (etcd on master & etcd not on master).

  1. quick installer can not be used when upgrade to v3.7 because a know issues[1], so [Using the Installer to Upgrade] section seems not needed. And in [Preparing for an Automated Upgrade] section, "yum update openshift-ansible" is a must instead of atomic-openshift-utils

[1]https://bugzilla.redhat.com/show_bug.cgi?id=1496372

  1. release notes, section [OpenShift Container Platform 3.7 Release Notes]-[INCREASED CONTROL OVER IMAGE STREAM AND TEMPLATES], RPM and Container's directory should be changed with each other.

RPM = /etc/origin/examples /etc/origin/hosted
Container = /usr/share/openshift/examples /usr/share/openshift/hosted

defined in a role.

[[ocp-37-flexvolume-support-for-non-stotage-use-cases]]
==== Official FlexVolune Support for Non-storage Use Cases
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is more like a storage feature, but for the security part, maybe we can write something about "SCC now support flexVolume" that we did in this card: https://trello.com/c/YT6sNEay/61-5-scc-flex-volume-support-sccfsi37

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

BTW, typo in "FlexVloune"

traffic to allow. The annotation is as follows:

----
$ oc annotate namespace ${ns} 'net.beta.kubernetes.io/network-policy={"ingress":{"isolation":"DefaultDeny"}}'
Copy link

@bmeng bmeng Nov 15, 2017

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The annotation is not needed now when we are using the v1 api.

Example:

----
clusterNetworkCIDR: 10.1.0.0/24, 10.1.5.0/24, 10.2.1.0/24 …

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The example should be like this:

networkConfig:
  clusterNetworkCIDR: 10.128.0.0/24
  clusterNetworks:
  - cidr: 11.128.0.0/24
    hostSubnetLength: 6
  - cidr: 12.128.0.0/24
    hostSubnetLength: 6
  - cidr: 13.128.0.0/24
    hostSubnetLength: 4
  externalIPNetworkCIDRs:
  - 0.0.0.0/0
  hostSubnetLength: 6

There are multiple comma-delimited CIDRs in the configuration file. Each node is
allocated only a single subnet from within any of the available ranges. You can
not allocate different-sized host subnets, or use this to change the host subnet
size The `clusterNetworkCIDRs` can be different sizes, but must be equal to or

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nodes could allocate different-sized subnets by setting different hostSubnetLength
Lack of period between size The

allocated only a single subnet from within any of the available ranges. You can
not allocate different-sized host subnets, or use this to change the host subnet
size The `clusterNetworkCIDRs` can be different sizes, but must be equal to or
larger than the host subnet size It is not allowed to have some nodes use

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Lack of period between size It is

their current application.

An external provisioner is used to access the EBS, GCE pDisk, HostPath, and
Cinder snapshotting API. This Technology Preview feature has tested EBS and
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@xltian what test cases do we have in this area?

----
$ oc create -f snapshot.yaml
apiVersion: volume-snapshot-data.external-storage.k8s.io/v1
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The apiVersion has changed to "volumesnapshot.external-storage.k8s.io/v1"

The `generatedeploymentconfig` API endpoint is now removed

[discrete]
[[deprecating-some-plicy-related-apis]]
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"plicy", typo here.

data centers, enabling organizations to implement a private PaaS that meets
security, privacy, compliance, and governance requirements.

[[ocp-36-about-this-release]]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

-37-?

xref:../install_config/index.adoc#install-config-index[Installation and
Configuration] documentation.

[[ocp-36-new-features-and-enhancements]]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

-37-?

CRI-O v1.0 (currently in xref:ocp-37-technology-preview[Technology Preview]) is a
lightweight, native Kubernetes container runtime interface. By design, it
provides only the runtime capabilities needed by the kublet. CRI-O is designed
to be part of Kubernetes and evolve in lock-step with the platform.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@runcom @mrunalp we need some warning here that using CRIO w/ builds will not work right?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Right, your PR haven't made 3.7

clusterNetworkCIDR: 10.1.0.0/24, 10.1.5.0/24, 10.2.1.0/24 …
----

[[ocp-37-routes-alloed-to-set-cookie-names-for-session-stickiness]]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

alloed->allowed?


* To set parameters, create a secret with values.
* Create a `TemplateInstance` containing the whole template you want to
instantiate, and a reference to the secret created above.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this references "the secret created above" but there are no instructions for creating the secret. Anyway we have official docs for this, can we just point there instead of duplicating it here?
https://docs.openshift.org/latest/rest_api/examples.html#template-instantiation

{product-title} now includes needed Prometheus monitoring and alerting. Expose
build step timings (time to pull images, fetch sources, run assemble, commit
images, push images). Expose failure reasons (for example, see that builds are
consistently failing due to failure to fetch source).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the build step timings are not exposed as prometheus metrics. So this is two things:

  1. prometheus metrics that show you the health of builds in the system (number running, failing, failure reasons, etc)
  2. timing information on build objects themselves to show how long they spent in various steps (not exposed as prometheus metrics)

break down an entire configuration map or secret into environment variables without
explicitly setting `env name` to `key mappings`.

[[ocp-36-notable-technical-changes]]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

-37- (probably need to grep the whole file for these)

==== Official FlexVolune Support for Non-storage Use Cases

There is now a supported interface to allow you to bind and mount in content
from a running pod. FlexVolume is a script interface that runs on the kublet and
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo of kubelet.

xref:../admin_guide/managing_networking.adoc#admin-guide-manage-networking[Managing
Networking] for more information.

[[ocp-27-cluster-ip-range-more-flexible]]
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

-37-

Me Again* per quota type. Administrators can create custom messages to the quota
warning.

[[ocp-47-environment-variable-editor-added-to-stateful-sets-page]]
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

-37-

[[ocp-37-installation]]
=== Installation

[[ocp-37-migrate-etcd-before-upgarde]]
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo of upgrade

=== Metrics and Logging

[[ocp-37-journald-system-logs]]
==== Jouranld for System Logs and JSON File for Container Logs
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo of Journald.

on OpenShift] for more information.

[[ocp-37-integrated-approach-to-adding-hosa]]
==== Integrated Approach to Adding Hawkular OpenShift Agent (Techology Preview)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo of Technology.

consisting of:

* a simple directory structure with named action playbooks.
* metadata (required and optional parameters, as well asdependencies).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missing space between "asdependencies"

manually using standardized container creation tooling, or with APB tooling that
Red Hat will deliver, which provides a guided approach to creation.

[[ocp-37-iopenshift-template-broker]]
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Extra 'i' before openshift


image::3.7-bind-mongodb-nodejs-at-creation.gif[connect a service]

[[ocp-37-include-templates-from-oter-projects]]
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo of other.

{product-title} 3.7 introduces the following notable technical changes.

[discrete]
[[ocpapi-connectivity-variables-now-deprecated]]
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missing '-' between "ocapi"

than the published OpenShift API service endpoints. To connect to the OpenShift
API in these contexts, use
xref:../dev_guide/service_accounts.adoc#dev-guide-service-accounts[service DNS]
or the automatically exposed `KUBERENTES`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo of KUBERNETES.

@taneem-ibrahim
Copy link

Hello, is encrypting_data section supposed to say "This is an alpha feature and may change in future" in 3.7 (it was mentioned as alpha in 3.6 as well)?


Docker log driver is set to `json-fiile` as the default for all nodes. Docker
`log-driver` can be set to `journal`, but there is no log rate throttling with
journal driver. So, there is always a risk for denial-of-service attacks from
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

journal -> journald

@ahardin-rh ahardin-rh force-pushed the ocp-3-7-release-notes branch from 13677bf to a1b3d34 Compare November 27, 2017 17:45
@openshift-ci-robot openshift-ci-robot added the size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. label Nov 27, 2017
@ahardin-rh ahardin-rh force-pushed the ocp-3-7-release-notes branch 4 times, most recently from a6e0124 to d0effbb Compare November 27, 2017 23:43
@ahardin-rh ahardin-rh changed the title [WIP]Added OCP 3.7 Release Notes Added OCP 3.7 Release Notes Nov 28, 2017
@ahardin-rh ahardin-rh force-pushed the ocp-3-7-release-notes branch from d0effbb to 08d40a6 Compare November 29, 2017 01:12
@ahardin-rh ahardin-rh merged commit 76761a0 into openshift:master Nov 29, 2017
@adellape
Copy link
Contributor

🔥 🔥 🔥 🔥 🔥 🔥 🔥

@anpingli
Copy link

@adellape the default logger driver is Journald in v3.7. https://bugzilla.redhat.com/show_bug.cgi?id=1513409.

==== Jourald for System Logs and JSON File for Container Logs

Docker log driver is set to `json-file` as the default for all nodes. Docker
`log-driver` can be set to `journal`, but there is no log rate throttling with
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

journal -> journald

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@juzhao Thanks, fixed in #6556

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

branch/enterprise-3.7 size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.